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Chapter 1. Introduction 


IBM 5100 PORTABLE COMPUTER SERIAL I/O ADAPTER FEATURE 
OVERVIEW 

The IBM 5100 Portable Computer Serial I/O Adapter feature allows a variety of 
external I/O devices to be attached to an IBM 5100, such as: 

• Plotters and graphic display devices 

• Card readers and/or punches 

• Printers 

• Instrumentation devices 

Only one external I/O device at a time can be attached to the 5100 and the device 
must supply its own power. The specifications for attaching an external I/O device 
using the Serial I/O Adapter feature are described in Chapter 4. 

The Serial I/O Adapter feature is the connection between the 5100 language (APL 
or BASIC) and the external I/O device. The feature uses one of the following codes 
when transmitting data to or receiving data from the external I/O device: 

• 5-bit 

• 6-bit (plus parity) 

• 7-bit (plus parity) 

• 8-bit 

The 5-bit, 6-bit, and 7-bit codes are compatible with I/O devices that use the 
Baudot, EBCD (extended binary coded decimal), and ASCII (American standard 
code for information interchange) character formats, respectively. The 8-bit code 
is compatible with I/O devices that use an 8-bit binary character format. 

When transmitting data, the 5100 characters are converted into 5-bit, 6-bit, 7-bit, 
or 8-bit code. When receiving data, the 5-bit, 6-bit, 7-bit, or 8-bit codes are con¬ 
verted into 5100 characters. 

Because the Serial I/O Adapter feature interacts with the BASIC or APL language, 
it cannot be used while the communications feature (if installed) is being used. 
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THINGS TO KNOW ABOUT YOUR I/O DEVICE 


You should know the answers to the following questions before using the Serial 
I/O Adapter feature. The answers to these questions will help you to specify the 
correct device characteristics which are discussed in Chapter 3. 

1. What code (5-bit, 6-bit, 7-bit, or 8-bit) does the I/O device use?_ 

2. What is the data rate (bits per second) required by the I/O device? _ 

3. Does the I/O device require an input prompting character from the 5100 to tell 

it to send data?_ 

4. What cable (modem or terminal) is used to attach the I/O device to the 5100? 


Note: See Appendix A. Set Up Procedure for information on which cable is 
used. 

5. For 7- and 8-bit codes only, how many stop bits (one or two) are required by 

the I/O device (transmit operations only)?_ 

6. For 7-bit code only, what parity (odd, even, or none) is required by the I/O 
device? 



GETTING STARTED 


If the Serial I/O Adapter feature is installed, the following procedure allows you to 

use your 5100 with an external I/O device: 

1. Insert the tape cartridge containing the Serial I/O Adapter program into the 
built-in tape unit and execute a )MODE COM command (if you are using 
APL) or UNTIL MODE COM command (if you are using BASIC) to dis¬ 
play the option menu. 

2. When the option menu is displayed, enter one of the following numbers or 
T to select the required code: 

• 5 (selects 5-bit code) 

• 6 (selects 6-bit code) 

• 7 (selects 7-bit code) 

• 8 (selects 8-bit code) 

• T (selects the Serial I/O Adapter self test; see Serial I/O Adapter Self Test, 
in Appendix A, for a description of this test) 

Once the code is selected, the correct version of the Serial I/O Adapter pro¬ 
gram is loaded into user storage. 

Note: Any user-defined programs or data is cleared from the user storage 
when the Serial I/O Adapter program is loaded. Also, the storage required 
for the Serial I/O Adapter program (approximately 4K bytes) is subtracted 
from the available user storage. 

3. Now, using the 5100 language (APL or BASIC), you can: 

a. Adapt the 5100 to the requirements of the I/O device by specifying the 
appropriate device characteristics (opening the command device and 
specifying the device characteristics are discussed in Chapters 2 and 3, 
respectively). 

b. Open the I/O device and perform input or output operations (opening 
the I/O device is discussed in Chapter 2). When using APL, input or 
output operations are performed using an APL shared variable. When 
using BASIC, input or output operations are performed using GET, PUT, 
or PRINT statements or LOAD and SAVE commands. 
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EXAMPLE PROGRAMS 


The APL and BASIC example programs show how 80-column records might be 
read from a hypothetical I/O device. These example programs do not explain in 
detail how the Serial I/O Adapter feature works; however, they will give you an 
idea of how the Serial I/O Adapter feature interacts with the APL or BASIC 
languages. Chapters 2 and 3 describe how the Serial I/O Adapter feature works 
and how to specify the device characteristics. Chapters 4 and 5 describe using the 
Serial I/O Adapter feature with the APL or BASIC language, respectively. 


APL Example Program 


O ..I 

7::i 
81 
9 ::i 

:i. o 


1.2 
1.3 
1.1+ 
1.5 


.i. i 

18 


. 1 . 7 

2 0 
21 
9 2 

'> 7 


2 '■!■ 
25 


29 
3 0 


3 »-l 

36 

37 

38 

39 


7 READ i: [| :i7 
V READ;DATA;X 

h x x x x x x •)(• x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x •>»> x x x x x x x x x x x 
ft E 53 T A B L 1S H A S H A R E D V A RIA B L E 

i"i X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X - X X X X X X X X X X X X X X X X X X X X X X X X X X X 
ft 

1 osVO * DATA‘ 

ft 

|Vj x X* X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X- X* X X X X X X X X X X X X X X 

ftX ADAPT THE 510 0 TO THE I/O DEVICE REQUIREMENTS # 

jVj X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X •)(• X X X X X x 

ft ^——--— 

DATA*- 1 OUT 310 01' 


Open the command device. 


DATA*- ’ R/30 0 .■ H/P , 1/82 * 
DAT A*- \ 0 


■ User-specified device characteristics; these device charac¬ 
teristics are used to adapt the 5100 to the I/O device 
requirements, such as, data rate, input prompting character, 
buffer size, and so on. Chapter 3 describes each user 
specified device characteristic in detail. 

Close the command device (by assigning 1 0 to the shared variable). 


ft X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X- X •)(• X X X X X 

ft TRANSFER DATA FROM THE I/O DEVICE TO THE 5.100 
i-i x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x- •)<• x- x- 

i.i ^- Open the input device. 

ft 

A ^ Assign an input record to the shared variable DATA. The 

DATA*- ‘ IN 33 0 0 1 ‘ value of DATA is then assigned to the variable X. 

I LOOP : X* DATA -*- 

X - Display the input record. 


V./ • end ‘ /3t.X >/LOOP 
DA rA*• \ 0 


This program expects the last input record to begin with 
the characters END. 


■Close the input device after the last input record is received. 


ft 
ft 
ft 

ft x X X -X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X- X X X X X X X X X X X 

ftx RETRACT THE SHARED VARAIBLE * 

ft X X X X X- X X X X X X X X X X X X X X X X X X X X -X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X - X X 
ft 

OSVR ’DATA’ 


V 


4 






























BASIC Example Program 


(l i ) j I I |7 I" M X - X X X -X- X- X X - X X- X # X X X X' X X- X X - X X X' X X- X X X X- X X X' X X: X X X: X X; X - X: X; X - X: X - X; X: X; X- X X' X" X: X: 

0 0 2 0 REM * ADAPT THE 5:1.0 0 TO THE I/O DEVICE REQUIREMENTS 

0 0 3 0 R I" M X: X- X; X: X X: X' X- X X X- X- X: X; X- X X- X X X- X- X: X: X: X: X' X X: X X: X: X: X: X X- X- X X X X} X X X X: X: X: X: X- X; X X- X X; X; X: X 

0 0M- 0 REM --Open the command device. 

0 0 50 OPEN ELI.. ' A08 ‘ fOUT 

0 0 6 0 P R I N I P L. 1 .• ' R/ 3 0 0 .■ H/ P .< !• /C .■ I / 9 / ' - -- — User-specified device characteristics; these device 

0 0 7 0 CLOSE FLI characteristics are used to adapt the 5100 to the 

0 080 REM I/O device requirements, such as, data rate, input 

0 0 9 0 REM prompting character, buffer size, and so on. 

0 I 0 0 REM Chapter 3 describes each user-specified device 

0110 REM characteristic in detail. 

0120 REM 
0130 REM 
01MO REM 

0 1 5 0 R E M X X- X' X - X X X- X X X X X X X X X X- X X- X' X X X: X- X: X X X: X X X X' X X- X" X X X X X- X X X - X X X’ X’ X: X X X} X X; X: 

0160 REM X OPEN THE I/O DEVICE FOR INPUT OPERATIONS » 

(i 1 7 (i 17 1" M x x x x X: x X' x x x x x x x x x x x x x x x x x x x- x x x x x x x x x x x x x x x x x x x x x x x x x x x x x 
0180 REM 

0190 OPEN FL2,. ' A02 * , IN 
0200 REM 

0 2 :i 0 R E M x x x x x x x x x x x x x x x x x x x x x x x x x x- x x x x x x x x x- x x x x x x x x x x x x x x x x x x x x x 
0 22 0 REM x- PERFORM I/O OPERATIONS #■ 

0 2 3 0 17 E M x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x 
02M0 REM 

0 q ppj^ -Assign the input record to the referenced variables. 

0 2 6 0 G E T F L 2 .- A $ , B $ , C T-D , E $ 

0270 PRINT A$ ; B$ ; Cf>; D$ ; E$-> -- Display the input record 

0 78 0 I F A$7 FNI'I ' ROTO I) 7 6 0 — --- Thls P r0 9 ram expects the last input record to begin 

7 g j.jj.;., v , . with the characters END. 

0 3 0 0 17 E M X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X 

0310 REM x CLOSE THE INPUT DEVICE AND END THE PROGRAM # 

0 3 2 0 17 F M x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x 

0330 REM 

03M0 CLOSE FL2 

0350 END 
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Chapter 2. How The Serial I/O Adapter Feature Works 


The following sections contain information about: 

• The 5-, 6-, 7-, and 8-bit codes 

• The input and output process arrows 

• The timing requirements 

• Loading IMFs (internal machine fixes) 

• The buffers 

• The input new-line and input end-of-block characters 

• The output new-line and output end-of-block characters 

• The device addresses (opening the command and I/O devices) 

You should be familiar with this information when using the Serial I/O Adapter 
feature. 


HOW THE 5-, 6-, AND 7-BIT CODES ARE USED 

The 5-bit, 6-bit, or 7-bit codes can represent Baudot, EBCD, or ASCII characters, 
respectively. However, internally the 5100 does not use these codes (characters). 
For output operations, the 5100 characters are converted into 5-, 6-, or 7-bit codes 
that are then transmitted by the 5100. For input operations, the 5-, 6-, or 7-bit 
codes received by the 5100 are converted to 5100 characters. 



This conversion is done using the translation tables provided by the Serial I/O 
Adapter program. The translation table contains the 5100 character and the 
equivalent 5-, 6-, or 7-bit code. The following illustration shows a 5100 character 
converted to 7-bit code and transmitted to a graphic display device. 



5100 User Storage 


Serial I/O Adapter 
Feature 


Graphic Display 
Device 
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When the 5100 receives codes that contain parity or stop bit errors, these codes 
are converted into ID (O-U-T) characters. When transmitting data, untranslatable 
characters are transmitted as blanks (5- and 6-bit codes) or as all one bits (7-bit 
code). 


5-Bit Code Translation Tables 

There are two 5-bit code translation tables, one for input and one for output. The 
input table specifies the 5100 character to use for each 5-bit code received, and the 
output table specifies the 5-bit code to transmit for each 5100 character. 

The 5-bit code input and output translation tables can be modified. See Change 
The Output Translation Table and Change The Input Translation Table in Chapter 
3 for information on how to change these tables. 


6-Bit Code Translation Tables 

There are four 6-bit code translation tables, an input and an output table for the 
APL language and an input and an output table for the BASIC language. Depending 
upon which translation table (APL or BASIC) is specified, the input table specifies 
the 5100 character to use for each 6-bit code received, and the output table specifies 
the 6-bit code to transmit for each 5100 character. 

The 6-bit code input and output translation tables can be modified. See Change 
The Output Translation Table and Change The Input Translation Table in Chapter 
3 for information on how to change these tables. 


7-Bit Code Translation Tables 

There are two 7-bit code translation tables, one for input and one for output. The 
input table specifies the 5100 character to use for each 7-bit code received, and 
the output table specifies the 7-bit code to transmit for each 5100 character. 

The 7-bit code input and output translation tables can be modified. See Change 
The Output Translation Table and Change The Input Translation Table in Chapter 
3 for information on how to change these tables. 



HOW THE 8-BIT CODES ARE USED 


< 

( 


The 8-bit codes can represent 256 different binary values. To generate all 256 
combinations, you must use the hexadecimal representation of the 8-bit codes. 

Note for BASIC users: Hexadecimal constants (for example, A$ = X'F9') are not 
used to enter the hexadecimal representation. 

The hexadecimal representation of the 8-bit code is two characters from 0 through 9 
or A through F. The decimal values and binary values for the characters A through 
F are: 



Character 

Decimal Value 

Binary Value 

A 

10 

1010 

B 

11 

1011 

C 

12 

1100 

D 

13 

1101 

E 

14 

1110 

F 

15 

1111 


The 8-bit code is divided into two 4-bit parts, with each part represented by a single 
hexadecimal character. The hexadecimal character is determined as follows: 




4 bits of an 8-bit code 


The decimal value for each of the 4 bits when 
determining the hexadecimal character 


DJ 

0 

1 



T= 0 


2 

0 

8 


The decimal values of each one bit are added 
together to determine the hexadecimal charac¬ 
ter that represents the 4 bits 


10 = Hex A-*-— The hexadecimal character A represents 
the decimal value 10 
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The following illustration shows an 8-bit code with a hexadecimal representation 
of F2: 


| Part 1 

Part 2 | 

LL 

1 

1 

1 

0 

0 

1 

_2J 



15= F 


2 


When transmitting data, the 5100 converts two characters (which must be the 
hexadecimal representation of 8 bits) into the 8-bit code. When receiving data, the 
5100 converts the 8-bit code into two characters (which are the hexadecimal 
representation of the 8 bits). This conversion is done using a translation table 
provided by the Serial I/O Adapter program. The translation table contains the 
two-character hexadecimal representation of the 8-bit code. The following illustra¬ 
tion shows two 5100 characters converted to 8-bit code and transmitted to a 
graphic display device (in this case, the I/O device recognizes this 8-bit code as the 
character 2): 



Graphic Display ^ 

1 Serial I/O Adapter 

5100 User Storage 

Device 

Feature 





The following example shows how the hexadecimal representation of an 8-bit 
code is entered using the APL and BASIC languages: 





\ 


An APL shared variable 


The equivalent 8-bit code 


A BASIC PRINT statement 


Note: A BASIC PUT statement should not 
be used when using 8-bit code. 


Notes: 

1. When transmitting data, two 5100 characters are converted to an 8-bit code, 
unless: 

a. One of the characters is not a valid hexadecimal character (0-F). In this case, 
an 8-bit code of all ones (hex FF) is transmitted. 

b. There is an odd number of characters in the record to be transmitted. In this 
case, an 8-bit code of all ones (hex FF) is transmitted for the last (odd) 
character in the record. 

2. When receiving data, each 8-bit code is converted into two 5100 characters, 
unless: 

a. The 8-bit code has an error (for example, stop bit error). In this case, the 
8 bit code is converted into two (D (O-U-T) symbols. 

b. The 8-bit code represents an input new-line or input end-of-block character. 
See Input New-Line and Input End-of-Block Characters in Chapter 2 for 
more information about what happens when an input new-line or input end- 
of-block character is received. 
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INPUT AND OUTPUT PROCESS ARROWS 


During input or output operations, one of four arrows (<--* + +) is displayed to 
indicate the status of the input or output operation. When using the APL 
language, the arrows are displayed in the upper right corner of the display screen. 
When using the BASIC language, the arrows are displayed in the lower right 
corner of the display screen. These arrows indicate the status of the input or 
output operation as follows: 

Arrow Meaning 

The 5100 is receiving data from the input device. This arrow 
moves in a back-and-forth motion as characters are received. 

-> The 5100 is transmitting data to the output device. This arrow 

moves in a back-and-forth motion as the characters are transmitted. 

t If in modem mode, the 5100 is waiting for the input device to 

request to send data (turn on request to send [RTS]). If in 
terminal mode, the 5100 is waiting for the output device to indi¬ 
cate it is ready for the transmitted data (turn on clear to send 
[CTS]). 

4- If in modem mode, the 5100 is waiting for the input device to 

stop requesting to send data (turn off request to send [RTS]). If 
in terminal mode, the 5100 is waiting for the output device to stop 
indicating it is ready for the transmitted data (turn off clear to 
send [CTS]). 

Note: These arrows are not displayed if the IN PROCESS light is on. 


TIMING REQUIREMENTS 

The user has the responsibility for determining that the timing requirements of the 
external I/O device can be met when other IBM 5100 input and/or output opera¬ 
tions or computations are interleaved with the I/O device operation. Typical input 
or output operations take 300-600 milliseconds besides the actual data transmission 
time. Transmitting and receiving data through the Serial I/O Adapter feature can¬ 
not be done simultaneously or overlapped with other 5100 operations. 



LOADING IMFs 


If IMFs (internal machine fixes) are required when using the Serial I/O Adapter 
feature, the IMFs must be loaded after the Serial I/O Adapter program is loaded. 

If you attempt to load the Serial I/O Adapter program and IMFs are already loaded, 
the program will not load and the message IMFS LOADED PRESS EXECUTE 
is displayed. In this case, you can do one of the following: 

1. Press RESTART, load the Serial I/O Adapter program, and then load the 
required IMFs. 

2. Press EXECUTE. The 5100 will return to the APL or BASIC language. 

See IBM 5100 APL Reference Manual, SA21 -9213, or IBM 5100 BASIC Reference 
Manual, SA21-9217, for information on how to load IMFs. 


IF THE SERIAL I/O ADAPTER PROGRAM IS ALREADY LOADED 

If you attempt to load the Serial I/O Adapter program and one of the four versions 
of the Serial I/O Adapter program is already loaded, the program will not load 
(that is, the version of the program already loaded will not be replaced) and the 
following message is displayed: 

ALREADY LOADED 

PRESS T FOR TEST OPTION 

EXECUTE FOR RETURN 

In this case, you can do one of the following: 

1. Press EXECUTE. The 5100 will return to the APL or BASIC language and 
you can use the version of the Serial I/O Adapter program already loaded. 

2. Press RESTART and load another version of the Serial I/O Adapter program. 

3. Press T to select the Serial I/O Adapter self test. 
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THE SERIAL I/O ADAPTER BUFFER 


The serial I/O adapter buffer is part of the 5100 user storage and is reserved 
for input and output operations. During output operations, records are 
placed in the buffer until the data is transmitted. During input operations, 
records are received by the 5100 and placed in the buffer. After the 5100 is 
through receiving data, it then uses the data in the buffer. The following 
illustrations show the flow of data for input and output operations: 


Output Operations 


5100 User Storage 



Data is placed in the 
buffer using: 

An APL shared variable 
A BASIC PRINT or PUT statement 
A BASIC SAVE command 
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Input Operations 



Data is removed from 
the buffer using: 

An APL shared variable 
A BASIC GET statement 
A BASIC LOAD command 

The size of the buffer determines how much data can be placed in the buffer at any 
given time. When the device characteristics (see Chapter 3) are being specified, the 
Serial I/O Adapter feature always sets the buffer size to 204 bytes. The buffer size 
for input or output operations can be specified (see Set Input Buffer Size or Set 
Output Buffer Size in Chapter 3); however, the Serial I/O Adapter feature always 
allocates at least 204 bytes for APL output operations and for BASIC SAVE opera¬ 
tions. The maximum buffer size depends on the amount of available user storage. 

Note: When using 8-bit code (see How the 8-Bit Codes Are Used in this chapter), 
two bytes of the buffer are required for each 8-bit code transmitted or received. 
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INPUT NEW-LINE AND INPUT END-OF-BLOCK CHARACTERS 


The input new-line and input end-of-block characters are characters (representing 
5-, 6-, 7- or 8-bit codes) that have a special meaning when received by the 5100. 
These characters are used by the Serial I/O Adapter feature as follows: 

• The input new-line character indicates that a complete record was received. This 
character is translated into the 5100 code for end of record and placed in the 
buffer. 

• The input end-of-block character indicates that a complete block (one or more 
records) of data was received. This character is translated into the 5100 code for 
end of buffer and placed in the buffer. 

If the input new-line and input end-of-block character both represent the same 
5-, 6-, 7-, or 8-bit code, this character is translated into both 5100 codes for end of 
record and end of buffer when it is received. 

Unless you specify otherwise, the 5100 character equivalent of the input new-line 
and input end-of-block characters are: 


Code 

Input 

New Line 

Input 

End of Block 

5-bit 

c 

(carriage return) 

c 

6-bit 

▼ 

(end of transmission) 

¥ 

7-bit 

c 

(carriage return) 

c 

8-bit 

8D 

(carriage return) 

8D 


Note: If you are using the BASIC language, the 5100 characters not shown on the 
keyboard are described under Special Characters in Chapter 5. 

See Set Input New-Line Character and Set Input End-of-Block Character in Chapter 
3 for information on how to specify input new-line and input end-of-block characters. 



INPUT END-OF-RECORD AND END-OF-BUFFER CONDITIONS 


< 

( 

( 




The 5100 takes the following actions when an input new-line character, 
input end-of-block character, or the physical end of buffer is encountered when 
receiving data. 

Note: See Set Enable/Disable Input New-Line and Input End-of-Block Characters 
in Chapter 3 for information on disabling the actions normally taken by the 5100 
when an input new-line or input end-of-block character is received. 


Condition 


Action Taken 


Graphic Representation 
of the Buffer 


An input new-line 
character is received 
(indicating end of 
record). 


An input end-of-block 
character is received 
(indicating end of data). 


The 5100 code for 
end of record (hex E3) 
is placed in the buffer 
and the 5100 continues 
receiving data. 


The 5100 code for end of 
buffer (hex FF) is placed 
in the buffer and the 5100 
continues receiving data. 


Next Record 




Received f / 

Record ^-Hex E3 


K 




Received 
Record ' ^-Hex FF 


Note: If the input prompting 
mode is specified, the 5100 sends an 
input prompting character after the 
hex FF is placed in the buffer. 


A character that repre¬ 
sents both an input 
new-line and input 
end-of-block character 
is received. 


The 5100 codes for end 
of record and end of 
buffer are placed in the 
buffer and the 5100 
stops receiving data. 


The remaining portion 
of the buffer is unused. 


it 


Received y* 
Record 


Li 


Hex FF 
■—Hex E3 



Only two positions 
remain unused in the 
buffer. 


The 5100 codes for end 
of record and end of 
buffer are placed in the 
last two positions of 
the buffer and the 5100 
stops receiving data. 
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The following conditions apply to BASIC only: 


Condition 


Graphic Representation 
Action Taken of the Buffer 


Character mode (F/C, 
see Set Character or 
Numeric Mode in 
Chapter 3) is being 
used and one of the 
following conditions 
occurs: 

• An input new-line 

character is 
received j 

• Only three posi- | 

tions remain un¬ 
used in the buffer > 

An input end-of-block 
character is received 
and the input new-line 
and input end-of-block 
characters are not 
specified as the same 
character 


A single quote is placed 
in the buffer, followed 
by the 5100 codes for 
end of record and end 
of buffer, and the 5100 
stops receiving data. 

The 5100 code for end 
of buffer is placed in 
the buffer (without 
the single quote or end 
of record code) and 
the 5100 stops receiv¬ 
ing data. 





A BASIC source pro¬ 
gram is being loaded 
from an input device 
and an input new-line 
character is received. 


Note: This will cause 
an error condition; 
therefore, an input 
end-of-block charac¬ 
ter that is not equal 
to the input new-line 
character should not 
be used when the 
character mode (F/C) 
is used. 

The 5100 codes for 
end of record and 
end of buffer are 
placed in the buffer in 
positions 65 and 66, 
because BASIC 
source programs are 
limited to records 
equal to or less than 
64 characters. 


Received Record 




18 



OUTPUT NEW-LINE AND OUTPUT END-OF-BLOCK CHARACTERS 


The output new-line and output end-of-block characters are characters (represent¬ 
ing 5-, 6-, 7-, or 8-bit codes) that normally have a special meaning when transmitted 
to an output device (for example, to indicate a carriage return or line feed). These 
characters are transmitted when the following conditions occur: 

1. Both an output new-line character and an output end-of-block character are 
transmitted when the 5100 code for end of record (hex E3) is encountered 
in the buffer. 

2. An output new-line character or output end-of-block character is transmitted 
when the equivalent user-specified 5100 character is encountered in the 
buffer. 

3. For BASIC only, if no output new-line or output end-of-block character was 
previously transmitted and the physical end of buffer is reached, output 
new-line and output end-of-block characters are transmitted. However, if one 
or more of these characters was previously transmitted, they are not trans¬ 
mitted when the physical end of buffer is reached. 

Note: For conditions 1 and 3, if the output new-line and output end-of-block 
characters are both represented by the same character, only one character is 
transmitted to the output device. This transmitted character represents both a 
new-line and end-of-block condition. 

Unless you specify otherwise, the 5100 character equivalent of the output new-line 
and output end-of-block characters are: 



Output 

Output 

Code 

New Line 

End of Block 

5-bit 

c 

(carriage return) 

n 

(line feed) 

6-bit 

I 

(new line) 

I 

(new line) 

7-bit 

c 

(carriage return) 

n 

(line feed) 

8-bit 

8D 

(carriage return) 

0A 

(line feed) 


Note: If you are using the BASIC language, the 5100 characters not shown on the 
keyboard are described under Special Characters in Chapter 5. 

See Set Output New-Line Character and Set Output End-of-Block Character in 
Chapter 3 for information on how to specify output new-line and output end-of- 
block characters. 
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OUTPUT END-OF-RECORD AND END-OF-BUFFER CONDITIONS 


The 5100 places end-of-record (hex E3) and end-of-buffer (hex FF) codes in the 
buffer for the following conditions: 

For APL Operations: 

• An end-of-record code is placed after each record assigned to a shared 
variable. 


I A R E Ii A V A R IA B I... E <- ‘ R E 0 0 R 0 ' 


Buffer 



Hex E3 


• An end-of-buffer code is placed in the buffer when an empty vector is 
assigned to the shared variable. 


IA R E I) A V A RIA B I.., E *• \ 0 


Buffer 


Jii 


RECORD 





Hex FF 
Hex E3 


For BASIC Operations: 

• An end-of-record code is placed after each record generated with a PUT 
statement. 


PUT FU. , ' RECORD ' 




Buffer 


RECORD 


n 


'Hex E3 


• A PRINT statement contains the end-of-record and/or end-of-buffer codes. 


A$=X'E3FF‘ 

PRINT FU., * ABC * ; AT 



Buffer 


Hex E3FF 






The 5100 takes the following actions when an end-of-record code, end-of-buffer 
code, or physical end of buffer is encountered when transmitting data: 


Note: See Set Enable /Disable Output New-Line and Output End-of-Block 
Characters in Chapter 3 for information on disabling the actions normally taken 
by the 5100 when an end-of-record code (hex E3) or end-of-buffer code (hex FF) 
is encountered when the 5100 is transmitting data. 


Condition 


Graphic Representation 
Action Taken of the Buffer 


The 5100 code for end Output new-line and 
of record is encountered, output end-of-block 
characters are trans¬ 
mitted before the 
5100 transmits the 
next record. 


Next 

Record Record 



The 5100 code for end 
of buffer is encountered. 


The 5100 stops trans¬ 
mitting (without trans¬ 
mitting an output new- 
line or output end-of- 
block character). Any 
remaining data in the 
buffer is not transmitted. 



Any remaining data 
is not transmitted. 



The physical end of 
the buffer is reached. 


For APL operations, the 
5100 stops transmitting 
(without transmitting an 
output new-line or out¬ 
put end-of-block charac¬ 
ter). 


For BASIC operations, if 
no output new-line or 
output end-of-block 
characters were previously 
transmitted, these charac¬ 
ters are transmitted and 
the 5100 stops transmit¬ 
ting. However, if output 
new-line and/or output 
end-of-block characters 
were previously trans¬ 
mitted, the 5100 stops 
transmitting (without 
transmitting an additional 
output new-line or output 
end-of-block character). 



s — I 

The buffer does not 
contain any hex E3 or 
hex FF characters 



The buffer contains 
5100 end-of-record 
codes that cause out¬ 
put new-line charac¬ 
ters to be transmitted 


Note: If the output new-line and output end-of-block characters are both represent¬ 
ed by the same character, only one character is transmitted to the output device. 
This transmitted character represents both a new-line and end-of-block condition. 
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OPENING THE COMMAND AND I/O DEVICES 


The Serial I/O Adapter feature requires special device addresses to open the 
command and I/O devices before any input or output operations can be performed. 
Following is an example of opening the command device before specifying the de¬ 
vice characteristics (see Chapter 3) using the APL and the BASIC languages: 


A 



In APL, a shared variable must be used when opening 
a device. 


’ OUT (31)0 01 TYPE = 1 ' 


OPEN ELI, 



Command Device Address 



In BASIC, an OPEN statement must be used when 
opening a device. 


Note: The command device is not an external hardware device; instead, the com¬ 
mand device address refers to a part of the 5100 user storage where the values of 
the specified device characteristics are stored. 

See Chapters 4 and 5 for more examples of opening the devices using the APL or 
BASIC languages, respectively. 


For APL 



Device Address 

Description 

Use 

31 

Command device 

Specifying the user device characteristics. 

32 

Output device 

Transferring data to the I/O device 
(output operation). 

33 

Input device 

Transferring data from the I/O device 
(input operation). 

34 

Output device 

Transferring data to the I/O device 
(output operation). 


Notes About Device Addresses 31, 32, and 34: 

1. When device address 32 is specified, the data assigned to the shared variable 

is not transferred to the I/O device until the buffer is full or the output device 
is closed (assign i0 to the shared variable). 

2. When device address 31 or 34 is specified, each time data is assigned to the 
shared variable, the data is immediately transferred to the output device. 

3. You can transfer multiple records to the I/O device faster using device address 34 
rather than device address 32. 
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For BASIC 


Device Address Description 

A08 Command device 

A02 Input device 

A04 Output device 

A20 Input device 

A40 Output device 


Use 

Specifying the user device characteristics. 

Transferring data from the I/O device 
using a GET statement (input operation). 

Transferring data to the I/O device using 
a PUT or PRINT statement (output 
operation). 

Loading a BASIC program from the I/O 
device using a LOAD command (input 
operation). 

Listing or punching a BASIC program on 
the I/O device using a SAVE command 
(output operation). 


Note: Device addresses A20 and A40 can also be used for input/output operations 
using PUT, PRINT, and GET statements. However, it is recommended that these 
device addresses only be used for loading, listing, or punching a BASIC program. 
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Chapter 3. User-Specified Device Characteristics 




The user-specified device characteristics specify control information about the I/O 
device to the 5100. These characteristics are specified in a character constant with 
a comma separating each characteristic. 

Note: Blanks must not be used as separators in the character constant. 


Some device characteristics have a default value that is used if you do not specify 
that device characteristic. The device characteristics can be specified in any order 
and at any time the command device is open. Following are examples of specify¬ 
ing several device characteristics using the APL and the BASIC languages: 


In APL, the device characteristics must be assigned 
to a shared variable. 


Av- ‘,1/82 , R/96Q 0 .■ P/E,‘ 


T 


■Device characteristics must be separated by commas. 


PRINT FLA , ,r i/82.. E/9600 , P/E" 



In BASIC, the device characteristics must be specified 
using a PRINT statement. 


See Chapters 4 and 5 for more examples of specifying device characteristics using 
the APL or BASIC languages, respectively. 




24 




SET INPUT BUFFER SIZE 


The 5100 input buffer size should be set to the size of the largest record to be 
received plus two. The two extra bytes allow the 5100 to place an end-of-record 
and end-of-buffer code after the received record. 

SYNTAX l/n 

where n is an integer greater than 2 specifying the input buffer size. 
Note: If the input buffer is not set large enough, loss of data can occur. 



5-bit 

6-bit 

7-bit 

8-bit 

Default Values 

204 

204 

204 

204 


SET OUTPUT BUFFER SIZE 

The 5100 output buffer size should be set to the size of the largest record to be 

transmitted. 

The 5100 takes the following actions when an entire record cannot be placed in 

the output buffer: 

• For APL output operations using device address 32, the remaining portion of 
the record is placed in the output buffer after the data already in the buffer is 
transmitted. 

• For APL output operations using device address 34, an EXCEEDS MAXIMUM 
RECORD LENGTH error message is displayed and no data is transmitted. 

• For BASIC output operations, the remaining portion of the record is placed 
in the output buffer after the data already in the buffer is transmitted. 

Notes: 

1. For APL output operations and BASIC SAVE operations, the Serial I/O Adapter 
feature always allocates at least 204 bytes for the output buffer. 

2. When this device characteristic is specified and the output device is open, the 
output buffer size is not changed. In this case, the output device must be closed 
and then opened again before the output buffer size is changed. 

SYNTAX O/n 

where n is an integer greater than 2 specifying the output buffer size. 



5-bit 

6-bit 

7-bit 

8-bit 

Default Values j 

204 

204 

204 

204 
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SET DATA RATE 


The data rate specified depends on the requirements of the attached device. The 
data rate can be set from 20 bps (bits per second) to: 

2400.5 bits per second when using 5-bit code 

9600.5 bits per second when using 6-, 7-, or 8-bit codes 

Also, the data rate can be specified to a half cycle, for example, 134.5 bps. 
SYNTAX R/n[.5] 

where n is a positive number specifying the data rate. 



5-bit 

6-bit 

7-bit 

8-bit 

Default Values j 

75 

134.5 

110 

110 ! 




SET CHARACTER OR NUMERIC MODE 


(Only for BASIC input operations using a GET statement.) 


When performing input operations with character-only data, you can specify that 
the data is to be automatically placed in the buffer in 18 character blocks with each 
block enclosed in single quotes and separated by a comma. This allows any 
character-only data to be read with a GET statement by automatically providing 
the necessary delimiters (single quotes and commas). 


SYNTAX 



where: 


• C (character mode) specifies that the data is to be automatically 
blocked into 18-character blocks. 

• N (numeric mode) specifies that data is not to be automatically 
blocked into 18-character blocks. In this case, the necessary 
delimiters must be provided as part of the input data. 



5-bit 

6-bit 

7-bit 

8-bit 

Default Values | 

N 

N 

N 

LU 


1 -The F/N device characteristic 

cannot be specified for an 8- 
bit code. 

Note: When using the character mode (F/C), be sure the input buffer size (see Set 
Input Buffer Size in this chapter), is set large enough to contain the additional 
quotes and commas. The buffer size can be determined by the following formula: 

SIZE = RECORD + QUOTES + COMMAS + 2 


where: 

• RECORD is the size of the input record. (For 8-bit code, the size of the 
input record is 2 times the number of 8-bit codes received.) 

• QUOTES is the number of single quotes required to separate the record into 
18-character blocks. This value can be obtained by dividing RECORD by 9 
(if the result contains a fraction or odd number, round up the result to the 
nearest even whole number). 

• COMMAS is the number of commas required to separate each 18-character 
block. This value can be obtained by dividing QUOTES by 2, then sub¬ 
tracting 1 from the result. 
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SET PROMPTING OR NONPROMPTING MODE 


The prompting mode is specified when the input device requires an input 
prompting character before sending data to the 5100. When the prompting mode 
is specified, the 5100 automatically transmits the input prompting character (see 
Set Input Prompting Character) each time it is ready to receive data. 

When prompting mode is specified, the 5100 transmits the input prompting 
character to the I/O device to indicate that the 5100 is ready to receive data. 

During the transmission of the input prompting character, the 5100 becomes ready 
to receive data, thus eliminating any transmit-to-receive transition time. 

Following are two examples of using the @ (break or long space character) in 
prompting mode: 

1. Assume the 5100 is attached to another system that must receive a break 
before transmitting its own input prompting character. In this case, the 
5100 input prompting character is set to HI. When the 5100 requests input 
from the other system, the gj break is transmitted and the other system 
responds with its own input prompting character. Now, the 5100 can 
transmit data to the other system. 

2. (APL only) Assume the 5100 is receiving data from an I/O device that 
terminates transmit mode when a break is received. In this example, you 
want to stop receiving data before the I/O device is ready to stop transmitting 
data. If you press CMD 0 (the 0 key on the right side of the keyboard), 

the 5100: 

a. Stops receiving data from the I/O device 

b. Closes the I/O device 

c. Assigns an empty vector and 0 0 return code to the shared variable 


Also, in this example, assume you are using an APL user-defined function 
that contains statements to transmit a break by setting the input prompting 
character to H , opening the I/O device for input, and requesting input 
(transmits the input prompting character). After you have pressed CMD 0, 
the APL user-defined function can check the shared variable for an empty 
vector and 0 0 return code. When these conditions are met, the APL function 
should branch to the statements required to transmit the input prompting 
character. 

Since the input prompting character is also the break character, the I/O 
device terminates transmit mode. The 5100 then waits for an end of trans¬ 
mission character from the I/O device or, if specified, a receive timeout (see 
Set Receive Timeout in this chapter). After one of these conditions has 
occurred, the 5100 can transmit data to the I/O device. 


/ 
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SYNTAX 


where: 

• P (prompting mode) specifies that the 5100 will transmit an 
input prompting character 

• N (nonprompting mode) specifies that the 5100 will not transmit 
an input prompting character 



5-bit 

6-bit 

7-bit 

8-bit 

Default Values j 

\a _1 

P 

N 

N 


SET INPUT PROMPTING CHARACTER 

If the H/P (prompting mode) device characteristic is specified, the 5-, 6-, 7-, or 8-bit 
code that is equivalent to the specified 5100 character in the output translation 
table is used as the input prompting character. 

SYNTAX C/p 

where p is the specified 5100 character 



5-bit 

6-bit 

7-bit 

8-bit 

Default Values j 


V 


Ti 1 
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SET MODEM, IGNORE, TERMINAL, WAIT, OR SET MODE 


The 5100 must operate in one of five modes (modem, ignore, terminal, wait, or ^ ^ 

set) when using the Serial I/O Adapter feature. These modes determine the con¬ 
ventions used by the 5100 when: 

• Making a request to send data to the I/O device (turning on request to send 

[RTS]) r- -% 

• Indicating it is ready to receive data from the I/O device (turning on clear to 
send [CTS]) 

Following is a description of the conventions used in each mode: 

• In modem mode, the I/O device must first request to send data (turns request 
to send on), then the 5100 indicates when it is ready to receive the data (turns 
clear to send on). The 5100 turns clear to send off only after the 5100 code 
for end of buffer is placed in the buffer and the I/O device turns request to send 
off. 

• In ignore mode, the 5100 does not check for a request to send before indicating 
whether or not it is ready to receive data. The 5100 turns clear to send on when 
it is ready to receive data and turns clear to send off when the 5100 code for end 
of buffer is placed in the buffer. 

• In terminal mode, the 5100 requests to send data (turns request-to-send on), 
then waits for the I/O device to indicate when it is ready to receive the data 
(turns clear to send on). After the I/O device indicates it is ready to receive 

data, the 5100 begins transmitting. ' 

• In wait mode, the 5100 requests to send data (turns request to send on), then 
waits for the I/O device to indicate when it is ready to receive data (turns clear 
to send on). After the I/O device indicates it is ready to receive data, the 5100 
begins transmitting. (However, in this mode, four extra stop bits are added to 
allow the receiving device time to turn clear to send off.) As the 5100 is trans¬ 
mitting data, if the I/O device turns clear to send off, the 5100 stops transmitting 
and waits for the I/O device to turn clear to send on again. 

The wait mode allows the I/O device to control the data transfer from the 5100. 

For example, assume you have a printer that turns clear to send on and receives 
data. However, when the data for one print line is received, the printer turns 
clear to send off and prints the data. After the data is printed, the printer turns clear 
to send on again and receives another line of data. In this case, the wait mode causes 
the 5100 to stop transmitting data and wait as the printer prints each line. 
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• In set mode, the 5100 sets the request-to-send or clear-to-send indication on 
and ignores any request-to-send or clear-to-send indications from the I/O device. 

Note: Ignore, set, and wait modes are useful when the I/O device does not conform 
completely to the EIA RS232C /CCITT V.24-V.28 specification. 

! M 
I 

T 
W 

s 

where: 

• M specifies modem mode. 

• I specifies ignore mode. 

• T specifies terminal mode. 

• W specifies wait mode. 

• S specifies set mode. 



5-bit 

6-bit 

7-bit 

8-bit 

Default Values j 

M 

M 

M 

M 
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SET RECEIVE TIMEOUT 


This user-specified device characteristic allows you to specify the approximate 
number of seconds (from 1 to 300) the 5100 will wait for the input device to 
transmit data. If the input device does not transmit data to the 5100 within the 
specified time, the 5100 code for end of record (hex E3) and end of buffer (hex 
FF) is placed in the buffer and the 5100 stops receiving data. 

For APL operations, if there is no data in the input buffer and the input device 
does not transmit data to the 5100 within the specified time, the data returned to 
the shared variable is an empty vector. In this case, the return code assigned to the 
shared variable is 9 0. 

For BASIC operations in numeric mode (see Set Character or Numeric Mode in 
this chapter), if there are not enough records in the buffer for the GET statement 
and the input device does not transmit data within the specified time, an ERROR 
010 ddd is displayed and any existing data in the buffer is lost. 

This user-specified device characteristic prevents the 5100 from waiting for an 
indefinite period of time when the input device does not have any more records 
to transmit and does not indicate when there is an end of file condition. 

Note: In modem mode, after a receive timeout condition, the data is not returned 
to the APL or BASIC language until request to send from the I/O device turns off. 

(° 

SYNTAX T/ < 

v. n 

where: 

• 0 specifies that the 5100 will wait for an indefinite period of time for the input 
device to transmit data (disable the receive timeout). 

• n is a value from 1 to 300 that specifies the approximate number of seconds the 
5100 will wait for data from the input device. 


5-bit 

6-bit 

7-bit 

8-bit 

0 

0 

0 

0 


Default Values 




SET INPUT NEW-LINE CHARACTER 


The 5-, 6-, 7-, or 8-bit code that is equivalent to the specified 5100 character in the 
input translation table is used as the input new-line character. The input new-line 
character separates the records received by the 5100. 

SYNTAX N/c 

where c is the specified 5100 character. 


5-bit 

6-bit 

7-bit 

8-bit 

Default Values [ c 

V 

c 

8D 


SET INPUT END-OF-BLOCK CHARACTER 

The 5-, 6-, 7-, or 8-bit code that is equivalent to the specified 5100 character in the 
input translation table is used as the input end-of-block character. 

SYNTAX E/c 

where c is the specified 5100 character. 


5-bit 

6-bit 

7-bit 

8 bit 

Default Values | c 

T 

c 

8D 


SET OUTPUT NEW-LINE CHARACTER 

The 5-, 6-, 7-, or 8-bit code that is equivalent to the specified 5100 character in 
the output translation table is used as the output new-line character. 

SYNTAX L/c 

where c is the specified 5100 character. 


5-bit 

6-bit 

7-bit 

8-bit 

Default Values J c | 

X i 

c 

8D 


SET OUTPUT END-OF-BLOCK CHARACTER 

The 5-, 6-, 1-, or 8-bit code that is equivalent to the specified 5100 character in the 
output translation table is used as the output end-of-block character. 

SYNTAX B/c 

where c is the specified 5100 character. 


5-bit 

6-bit 

7-bit 

8-bit 

Default Values j n j 

I | 

n | 

0A 
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SET ENABLE OR DISABLE INPUT NEW-LINE AND INPUT 
END-OF-BLOCK CHARACTERS 


When performing input operations, the 5100 normally places an end-of-record (hex 
E3) code in the buffer when an input new-line character is received, or places and 
end-of-buffer (hex FF) code in the buffer when an input end-of-block character is 
received. You can disable this action normally taken by the 5100 to allow the 
5100 to receive multiple records from the input device. In this case, the 5100 rec¬ 
ognizes the data as only one record and continued to receive data until only two 
positions remain unused in the buffer or a receive timeout occurs (see Set Receive 
Timeout in this chapter). The 5100 then places an end-of-record and end-of-buffer 
code in the last two positions of the buffer. 


SYNTAX Z/ 



where: 


• E specifies that the 5100 places an end-of-record code or end-of-buffer code in 
the buffer when an input new-line character or input end-of-block character, 
respectively, is received. 

• D specifies that the 5100 does not place an end-of-record code or end-of-buffer 
code in the buffer when an input new-line character of input end-of-block 
character, respectively, is received. 


5-bit 6-bit 7-bit 8-bit 



Default Values 




SET ENABLE/DISABLE OUTPUT NEW-LINE AND OUTPUT 
END-OF-BLOCK CHARACTERS 


When performing output operations, the 5100 normally transmits an output 
new-line and output end-of-block character when the 5100 code for end-of-record 
(hex E3) is encountered in the buffer (and, for BASIC only, the physical 
end-of-buffer is reached). You can disable this action normally taken by the 5100 
if you want to transmit multiple records to the output device. 

Note: When the 5100 user-specified character equivalent of the output new-line 
or output end-of-block character is encountered in the buffer, the output 
new-line or output end-of-block character, respectively, is always transmitted. 

(e 

SYNTAX Y/ < 

ID 

where: 

• E specifies that the output new-line and output end-of-block characters are 
transmitted (enabled). 

• D specifies that the output new-line and output end-of-block characters are 
not transmitted (disabled). 


5-bit 6-bit 7-bit 8-bit 


Default Values 
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SET IMMEDIATE DELAY 


This user-specified device characteristic causes the 5100 to immediately delay (stop 
processing all statements or commands), for a specific period of time (in 1/10 
second intervals) whenever it is sent to the command device. For example, if you 
specify 3000, the 5100 delays for 300 seconds (five minutes) before processing any 
more statements or commands. This device characteristic can be specified any 
time the command device is open and can be specified more than once by an APL 
or BASIC program. 

This device characteristic is usually used when the 5100 is attached to an input 
device that takes measurements at specific time intervals (for example, the room 
temperature). 

SYNTAX D/n 

where n is an integer from 1 to 65535 specifying the number of 1/10 
seconds to delay. 


SET APL OR BASIC TRANSLATION TABLE 


(Only for 6-Bit code.) 

Appendix C shows the equivalent 6-bit code for each 5100 APL or BASIC character. 
During input operations, the 6-bit code is translated into the equivalent 5100 APL 
or BASIC character (depending on which translation table is used). During output 
operations, each 5100 character is translated into the equivalent 6-bit code (depend¬ 
ing on which translation table is used). 

This device characteristic specifies which 6-bit code translation table to use. For 
example, suppose you are using a BASIC program to transfer data to a device that 
prints APL characters, then you would want to specify the APL translation table. 

SYNTAX A/ 

where: 



• A specifies the APL translation table 

• B specifies the BASIC translation table 

5-bit 6-bit 7-bit 8-bit 


Default Values 



X. ,/ 


36 




CHANGE THE OUTPUT TRANSLATION TABLE 


(Only for 5-, 6-, and 7-Bit codes.) 

Each 5100 character is converted into the equivalent 5-, 6-, or 7-bit code (using an 
output translation table), before being transmitted to the I/O device. Appendixes 
B, C, and D show the equivalent 5-bit, 6-bit, and 7-bit codes for each 5100 character. 
The 5-, 6-, or 7-bit code equivalent of the 5100 character can be changed (by 
changing the output translation table) as follows: 

SYNTAX c>col/row 

where c is the 5100 character and col/row is the col/row value (see 
Col/Row column in Appendixes B, C, and D) of the new equivalent 
5-, 6-, or 7-bit code. 

An example of changing the APL 6-bit code output translation table: 

To change the translation of the 5100 character T from the 6-bit 
code for the EBCD character t (col/row = 103) to the 6-bit code 
for the EBCD character x (col/row = 107), enter T >107. Now, 
both 5100 APL characters T and X will be converted into the 
6-bit code for the EBCD character x. 

An example of changing the 7-bit code output translation table: 

To change the translation of the 5100 character JMrom the 7-bit 
code for the ASCII character p (col/row = 700) to the 7-bit code 
for the ASCII character z (col/row = 710), enter j^>710. Now, 
both 5100 characters_P and Z^will be converted into the 7-bit 
code for the ASCII character z. 
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CHANGE THE INPUT TRANSLATION TABLE 


(Only for 5-, 6-, and 7-Bit codes.) 

Each 5-, 6-, or 7-bit code received by the 5100 is converted into the equivalent 
5100 character (using an input translation table). Appendixes B, C, and D show 
the equivalent 5100 character for each 5-, 6- f or 7-bit code. The 5100 character 
equivalent of the 5-, 6-, or 7-bit code can be changed (by changing the input 
translation table), as follows: 

SYNTAX c< col/row 

where c is the 5100 character and col/row is the col/row value (see 
the Col/Row column in Appendixes B, C, and D) of the 5-, 6-, or 
7-bit code to be translated into the specified 5100 character. 

An example of changing the 6-bit code BASIC input translation 
table: 

To change the translation of the 6-bit code for the EBCD 
character s (col/row = 102) from the 5100 BASIC character S to 
the 5100 BASIC character2^, enter X< 102. Now, the 6-bit 
codes for both EBCD characters s and X will be converted into 
the 5100 BASIC character X. 

An example of changing the 7-bit code input translation table: 

To change the translation of the 7-bit code for the ASCII 
character p (col/row = 700) from the 5100 character £ to the 
5100 character Z, enter Z< 700. Now, the 7-bit codes for both 
ASCII characters p and z will be converted into the 5100 
character Z. 



SET INPUT/OUTPUT PARITY 


(Only for 7-Bit code.) 

The input/output parity can be set to odd parity or even parity depending upon 
the requirements of the I/O device, or parity checking can be turned off. 

( E 

SYNTAX P/<0 
(N 

where: 

• E specifies even parity. 

• 0 specifies odd parity. 

• N specifies no parity checking on input and a zero parity bit 
transmitted on output. 


5-bit 

6-bit 

7-bit 

8-bit 

Default Values | j 

0 

E 



The input/output parity cannot be changed 
when using 6-bit code. An error occurs if the 
device characteristic is specified. 


SET NUMBER OF STOP BITS 

(Only for transmitting 7- and 8-Bit codes.) 

The number of stop bits between characters can be set to 1 or 2. Normally, it 
doesn't matter whether the number of stop bits is one or two; however, some I/O 
devices require two stop bits between characters. 

SYNTAX S/n 

where n is the specified number of stop bits. 



5-bit 

6-bit 

7-bit 

8-bit 

Default Values j 

1.5 

1 

2 

2 1 



The number of stop bits cannot be changed when 
using 5- and 6-bit codes. An error occurs if the 
device characteristic is specified. 
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USER-SPECIFIED DEVICE CHARACTERISTIC AND DEFAULT 
VALUE SUMMARY 


User-Specified Device Characteristics 

Syntax 

5-Bit 

Default Values 
6-Bit 7-Bit 

8-Bit 

Set input buffer size 

l/n 

204 

204 

204 

204 

Set output buffer size 

0/n 

204 

204 

204 

204 

Set data rate 

R/n 

75 

134.5 

110 

110 

Set character or numeric mode (5, 6, 
and 7-bit code) 

"8 

N 

N 

N 

C 1 


Set prompting or nonprompting mode 


Set modem, ignore, terminal, wait, or 
set mode 


K/ \ T 

/W 


Set receive timeout 

T/ 

' n l 

0 

0 

0 

0 

Set input prompting character 

\ 

C/p 

f 

® 

▼ 

+ 

11 

Set input new-line character 

N/c 


c 

T 

c 

8D 

Set input end-of-buffer character 

E/c 


c 

T 

c 

8D 

Set output new-line character 

L/c 


c 

I 

c 

8D 

Set output end-of-buffer character 

B/c 


n 

I 

n 

0A 

Set enable or disable input 
new-line and input end-of-block 

Z/ < 

f E ) 

> i 

i 

> E 

E 

E 

E 


characters 


Set enable or disable output 
new-line and output end-of-block 
characters 


1 These default values cannot be changed and an error occurs if the device characteristic is specified. 
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Default Values 

User-Specified Device Characteristics Syntax 5-Bit 6-Bit 7-Bit 8-Bit 

Set immediate delay D/n 

Set APL or BASIC translation table 
(6-bit code only) 



Change the output translation table 
(5-, 6-, and 7-bit code) 


c>col/row 


Change the input translation table 
(5-, 6-, and 7-bit code) 


c< col/row 


Set input/output parity (7-bit code only) 



0 1 E 


Set number of stop bits (7- and 8-bit code) S/ 



1.5 1 


2 2 


l 


These default values cannot be changed and an error occurs if the device characteristic is specified. 
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Chapter 4. Using the APL Language and the Serial I/O Adapter Feature 


'•{ > 


Once the 5-, 6-, 7-, or 8-bit code is selected and the Serial I/O Adapter program is 
loaded into the workspace, the user can: 

• Load or copy a stored workspace, containing user-defined functions and 
variables, into the active workspace. 

Note: Because the storage required for the Serial I/O Adapter program is sub¬ 
tracted from the active workspace, you might not be able to load a stored 
workspace that was written to tape using the )CONTINUE command. 

• Perform input or output operations using an APL shared variable. Input or 
output operations that are going to be done more than once should be defined 
in a user-defined function. 

OUTPUT OPERATIONS 

When you use device address 32, the data assigned to the shared variable is placed 
in the buffer until the buffer is full (see Output End-of-Record and End-of-Buffer 
Conditions in Chapter 2), or until the output device is closed. Then the data is 
transmitted until: 

• The end of buffer is reached 

• The ATTN key is pressed (Any remaining data in the buffer is lost.) 

• An error occurs 

Note: Records are placed into the buffer until the buffer is full; therefore, data 
might not be immediately transmitted to the output device. However, closing the 
device (assigning an empty vector to the shared variable) causes the data to be 
transmitted immediately. 

When you use device address 34, the data assigned to the shared variable is 
immediately transmitted to the output device until: 

• The transmission is complete 

• The ATTN key is pressed (Any remaining data in the buffer is lost.) 

• An error occurs 

When you use device address 34, you can transmit multiple records faster because 
the output device does not have to be closed to transmit each record. Also, during 
all output operations, the data transmitted is a direct translation (character-by- 
character) of the data in the buffer. 
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INPUT OPERATIONS 


During input operations, data is received from the input device and placed into the 
buffer until: 

• The buffer is full 

• An input end-of-block character is received by the 5100 

• The CMD key is held and the 0 key (on the right side of the keyboard) is 
pressed. (An empty vector is assigned to the shared variable and the input 
device is closed.) 

• The ATTN key is pressed 

Note: It is recommended that you use the CMD 0 key rather than the ATTN 
key to terminate an input operation. 

• An error occurs 

The data placed into the buffer is a direct translation of the data received. If the 
input new-line character and the input end-of-block character are the same 
character, the data is immediately assigned to the shared variable; the shared 
variable can then be used in an expression in the active workspace. 


End-of-File Conditions During APL Input Operations 

During an input operation, an end-of-file condition means that the input device 
does not have any more records to transmit to the 5100. The Serial I/O Adapter 
feature recognizes an end-of-file condition when: 

• The input device indicates end of file by dropping the data terminal ready signal. 
(See Chapter 4, Connector and Pin Assignments for more information about 
the data terminal ready pin.) 

• The CMD key is held and the 0 key (on the right side of the keyboard) is pressed. 

Note: CMD 0 is generally used when the input device does not indicate an end- 
of-file condition, even though it does not have any more records to transmit to 
the 5100. In this case, the 5100 will wait for the input device to transmit data 
until CMD 0 is pressed. 

When the Serial I/O Adapter feature recognizes an end-of-file condition, an empty 
vector is automatically assigned to the shared variable and the input device is closed. 
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ESTABLISHING A SHARED VARIABLE AND SPECIFYING THE 
DEVICE CHARACTERISTICS 


Before input and/or output operations can be performed, a variable must be 
established as a shared variable and the device characteristics specified 
(see Chapter 3). To specify device characteristics, you must open the command 
device and specify the device characteristics. If the command device is not 
opened and the device characteristics specified, the default values for the device 
characteristics are used by the Serial I/O Adapter feature. 

Note: Once the Serial I/O Adapter program is loaded and a value is specified for a 
device characteristic, that value remains in effect until: 

a. Another value is specified. 

b. The RESTART switch is pressed. 

c. The 5100 POWER ON/OFF switch is turned off. 

Following is an example of establishing a shared variable and specifying some device 
characteristics: 


3. |"|SVO ' DATA ‘ -*-Establish DATA as a shared variable. 

--The 5100 responds with a 2 if the shared variable is 

successfully established. 


DATA*- ‘ OLH 
DATA 


33.0 0 3. MSG-OFF 


0 0 


'-Return Code (A non¬ 
zero return code 
indicates an error 
occurred.) 



type"" :i:' 


C 


DATA*- 

DATA 


1/82,E/30 0 


0 0 


Open the command device. 

The command device must use 
the exchange or general ex¬ 
change data format. 

This parameter is optional. 

Device address 31 (command device), file 1. 

Output operation (information is always sent to the 
command device). 

Note that commas are required between 
each device characteristic, and that blanks 
cannot be used as separators in the charac¬ 
ter constant. 


P/Ei 

_i 


I-Specify the device characteristics. 


*—In this case, the input buffer is set to 82 bytes, the data 
rate is set to 300 bps, and the parity is even. The re¬ 
maining device characteristics are not changed from 
their present values. 



0 0 


VECTOR*- * 1/82/ R/30 0 > P/E ' 


DATA*VECTOR 
DATA 


1 —A character variable specifying the device 
characteristics can also be used. 


The device characteristics can be specified in any order. Also, because the buffer is 
always automatically set to 204 when specifying device characteristics, assigning 
more than 203 characters (including commas) to the shared variable causes an 
EXCEEDS MAXIMUM RECORD LENGTH error message to be displayed. 

DATA* \ 0 --Close the command device (assign an empty vector 

DATA to the shared variable). The command device does 

0 0 not have to be closed. However, unless the command 

device is closed, another shared variable must be used 
to open the I/O device and transfer data (opening 
the I/O device and transferring data are discussed 
later in this chapter). 

Note: If the command device is closed, it must be reopened before any other 
device characteristics can be specified. 


OPENING THE I/O DEVICE 


After the shared variable is established and the device characteristics specified, the 
I/O device must be opened before data can be transferred. For example: 


DATA* 'IN 330 0 :l MSG™ OFF * 
DATA 


0 0 





OR 

DATA*’OUT 
DATA 


0 0 


L-Open an input device. 

This parameter is optional when open¬ 
ing an input or output device. 

Device address 33 (input device), file 1. 

Input operation. 

320 01 TYPE-1 * j 

c 



OR 


Open an output device using device address 32. 

An output device must use the exchange 
or general exchange data format. 

Device address 32 (output device), file 1. 

Output operation. 


DATA*’OUT 34-0 01' 



Open an output device using device address 34. 

In this case, you do not have to specify TYPE=1. 
However, only character scalars or vectors can 
be assigned to the shared variable. 


Device address 34, file 1. 


Output operation. 
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TRANSFERRING DATA 


After the input or output device is open, data can be transferred using the shared 
variable. 

Transmitting Data to the I/O Device (Output Operation) 

Using Device Address 32: 

When data (character scalar or vector only) is assigned to the shared variable, the 
data is placed into the buffer. If the data is to be transmitted immediately (before 
the buffer is full), the output device must be closed after each assignment to the 
shared variable. Once the device is closed, it must be reopened before more data 
can be assigned to the shared variable. 

Using Device Address 34: 

When data (character scalar or vector only) is assigned to the shared variable, the 
data is immediately transmitted to the I/O device. 

Note: If the amount of data assigned to the shared variable exceeds the buffer 
size, the message EXCEEDS MAXIMUM RECORD LENGTH is displayed and no 
data is transmitted. 


Receiving Data From the I/O Device (Input Operation) 

Data is received from the input device and placed into the buffer. Then, each time 

the shared variable is used, a new record from the buffer is assigned to it. 

Notes: 

1. If the input new-line and input end-of-block characters are the same character, 
only one record at a time is received from the input device and placed into the 
buffer. 

2. When data is received from an input device, an empty vector is assigned to the 
shared variable if the only data in the 5100 input buffer is hex E3FF. In this 
case, the return code assigned to the shared variable is 9 0. The condition where 
only hex E3FF is in the buffer might be caused by the 5100 receiving only an 
input new-line and input end-of-block character (see Input End-of-Record and 
End-of-Buffer Conditions in Chapter 2) or by a receive timeout (see Set Receive 
Timeout in Chapter 3). 



CLOSING THE I/O DEVICE AND RETRACTING THE SHARED 
VARIABLE 


After all the data is transferred, the I/O device should be closed and the shared 
variable name retracted. For example: 


DATA*- 

\0 -- 

-Close the I/O device by assigning an empty vector 

to the shared variable. 

HAT A 



0 0 


Retract the variable name being shared. 

0 SVR 

' DATA 



A.. 


5100 CHARACTERS THAT REQUIRE USING THE ATOMIC VECTOR 

There are two 5100 characters (% and <f) used with the Serial I/O Adapter feature 
that are not on the 5100 keyboard. To generate the % and 4 characters, you must 
use the atomic vector. The indexes (location) of the % and rf. characters in the 
atomic vector (assuming □ 10-^1) are 0AV[173] and []AV[184], respectively. 

The catenate (,) function is used to place these characters into a record. For 
example: 


sharedavariable*-*$1,000 @ ■+•,havi: 173:1 

SHAREMVARIABLE 
$1000 G «•!•% 
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INPUT DATA FLOW WHEN USING APL 


The following diagram shows the data flow from an input device to the 5100: 



Data is received by the 5100 
until the input buffer is full 
or an input end-of-block 
character is received. 


One record is assigned to the 
shared variable each time it 
is used. 




OUTPUT DATA FLOW WHEN USING APL 


The following diagram shows the data flow from the 5100 to an output device: 


APL I 

Shared | 

A record is placed in the buffer 
when it is assigned to the shared 
variable. 


5100 Output Buffer 

When device address 32 is used, records 
are placed in the buffer until the buffer 
is full or output device is closed, then the 
data is transmitted. When device address 
34 is used, each record is placed in the 
buffer and then transmitted immediately. 

Note: If an entire record cannot be placed 
in the buffer: 

• For device address 32, the remaining 
portion of the record is placed in the 
buffer after the data already in the 
buffer is transmitted (that is, no data 
is lost). 

• For device address 34, the message 
EXCEEDS MAXIMUM RECORD 
LENGTH is displayed and no data is 
transmitted. 


_y_ 

Translation 

Table 

\ Output 
Device 



Variable 

IT 
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SAMPLE APL PROGRAM 


The sample APL program shows how input and output operations can be performed 
using the IBM 5100 Serial I/O Adapter feature and an IBM 2741 Communications 
Terminal that uses EBCD code. To understand this example, you should be familiar 
with the following 2741 characteristics: 

• Normally attaches to a modem (data set). Therefore, the modem cable attaches 
the 2741 to the 5100. 

• Uses a 6-bit code. 

• Requires a data rate of 134.5 bps. 

• Uses the APL character format. 

• Is placed in transmit mode when the POWER ON/OFF switch is turned on. 

• When transmitting data: 

a. Sends a character to indicate the start of the data. If the APL transla¬ 

tion table is specified, the 5100 character ] is equivalent to the ([)) character. 

If the BASIC translation table is specified, the 5100 character # is equvalent 

to the (d) character. 

b. Sends a Qc) ( V ) character to indicate the end of the data (end of transmission). 

• Must receive a (5) character to identify the start of a message and a © character 
to indicate the end of data. 



VINAOUTCEDV 
v I NtiOUT ;CMOS;TEXT;A 


Establish a shared variable and specify the device characteristics. 


4 ::i a*-i. usvo 2 4 p ■ c mbstext 1 

5 ::i •+ (:i. - v / a x 2) / e e r 0 r ^ 

6CM 10Sf- ‘ OUT 3 ;|. 0 0 1 ’ ___' Check to make sure the operations are successful. 

7 ::i < < ;l. f c M B 8 ) X 0 > / E R R 0 E^ 

S I <":M (i“ E/ j "Oi 3 . T / | 1•:>. p/ -.>• , v /q • ^-The Serial I/O Adapter feature uses the default value for 

9 •( j f f;jvj (iq ) q > /j:: - j"' pfj p v any device characteristic not specified. 


I ^Turn clear to send (CTS) on for the 5100 and ignore any 

I request to send (RTS) from the 2741. 

! ft | ‘ “ Input operation. 

I TEXT*- * IN 330 01 ‘ 

I -m; at TEXT) X0) /ERROR 

I ‘THE 5.1.00 IS WAITING FOE INPUT FROM THE 2741 ’ 

j TEXT __ L _Display this message to indicate when the 5100 is waiting 

I TEXT*- \ 0 n. for input from the 2741. 

I ( (1 f T E X T ) X 0 ) / E R R 0 E 

j f ; ( ^ Display the input from the 2741. 

I ft 

| ft f Specify an immediate delay. 

I ’THE 5100 IS DELAYING FOR .1. MINUTE’ 

! C M D S *•' D / 6 0 0 ’ - - - —__ 


I ( < I f C M D 8 ) X 0 ) / E R R 0 E 

I C M D 8 <- \ 0 -- 

I -K (:l. f CMD8) X0 )/ERROR 


The 5100 will stop processing for one minute when this 
device characteristic is sent to the command device. 

‘Close the command device. 


Output operation. 


T E X T ' 0 U T 3 2 0 01 T Y P E ~ I ’ 

•K (IfTEXT)XO)/ERROR 

’ENTER THE MESSAGE TO THE 274.1.’ 

text*- ’ :r75 - - 

< I f TEXT ) XO ) /ERROR Th 


1 TEXTf- ’ III ~ ~ --- The ] is converted into the (d) character for the 2741. 

i ■> ( < 11 TEXT ) X 0 } /E RROR The (S) character must precede any data to the 2741. 

! ’NOW THE MESSAGE IS SENT TO THE 2741.' 

I f E X f \ 0 -- Close the output device to send the message to the 2741. 

I -m; < If TEXT) XO )/ERROR 

I H Note: The output device does not have to be closed to send 

I ft the message when device address 34 is used for the output 

I ft operation. 

I 4 E E T R A C T -—\ 

I E E R 0 E : ' A N E R R 0 R O C C U R R E D , T R Y A G AIN ’ \ 

I RETRACT: AHI1SVR 2 4 p ’ CMDSTEXT ’ \ 

V Retract the shared variable. 
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Using the Sample APL Program 

Before the sample APL program can be used, the following steps must be performed 

1. Attach the 2741 to the 5100 with the modem cable. 

2. Place the 5100 BASIC/APL switch in the APL position and turn the power on 
to the 5100 and the 2741. 

Note: If the power is already turned on, but the BASIC language is active, 
place the 5100 BASIC/APL switch in the APL position and press RESTART. 

3. Place the tape cartridge containing the Serial I/O Adapter program into the 
built-in tape unit and enter the command: 

)MODE COM 

Press EXECUTE. 

4. When the option menu is displayed, enter: 

6 

The message .CLEAR WS, is displayed when the Serial I/O Adapter program 
is loaded into the workspace. 

5. Load the sample program into the workspace (either by loading it from a 
tape cartridge or entering it from the keyboard). 

Now, you can use the sample APL program to perform input and output operations 

with the 2741. For example: 

1. Enter IN OUT and press EXECUTE to start the program. 

2. When the 5100 displays THE 5100 IS WAITING FOR INPUT FROM THE 
2741, enter FROM THE 2741 on the 2741 keyboard. As you are entering 
the data on the 2741 keyboard, notice the <- in the upper right corner of 
the 5100 display screen. This arrow moves in a back-and-forth motion as the 
5100 receives data from the 2741 (for more information on the Input and 
Output Process Arrows , see Chapter 2). After you enter the data, press the 
RETURN key on the 2741. The message you entered is then displayed by 
the 5100. 

3. After the 5100 displays the message from the 2741, it displays THE 5100 
IS DELAYING FOR 1 MINUTE. Now, the 5100 will not process any state¬ 
ments or commands for one minute. 

4. After the one minute delay, the 5100 displays ENTER THE MESSAGE TO 
THE 2741. When this message is displayed, enter FROM THE 5100 and 
press EXECUTE. Notice the -> in the upper right corner of the 5100 display 
screen after the 5100 displays NOW, THE MESSAGE IS SENT TO THE 2741. 
This arrow moves in a back-and-forth motion as the 5100 transmits data to 
the 2741. The message you entered is then printed on the 2741. 


This completes the execution of the sample APL program. 



Chapter 5. Using the BASIC Language and the Serial I/O Adapter Feature 


Once the 5-, 6-, 7-, or 8-bit code is selected and the Serial I/O Adapter program is 
loaded into the work area, the user can: 

• Enter a BASIC program from the keyboard or load a BASIC program from tape. 

• Perform input and output operations with an I/O device using a BASIC program. 

• Load a BASIC program from the I/O device. 

• List or punch a BASIC program on the I/O device. 


OUTPUT OPERATIONS 

BASIC output operations are initiated by PUT or PRINT statements in the user's 
program or by a SAVE command. During output operations, data is transmitted 
until: 

• The physical end of the buffer is reached. 

• An end-of-buffer character (hex FF) is encountered. 

• The ATTN key is pressed. (Any remaining data in the buffer is lost.) 

• An error occurs. 

The data transmitted is a direct translation (character-by-character) of the data in 
the buffer. 

If the PUT statement is used, records are placed into the buffer until the buffer is 
full. Therefore, the record might not be immediately transmitted to the output 
device. However, if the PRINT statement is used and a semicolon is not specified 
as the last delimiter, a record is immediately transmitted to the output device 
after it is placed into the buffer. 
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INPUT OPERATIONS 


BASIC input operations are initiated by a GET statement in the user's program 
or by a LOAD command. During input operations, data is received until: 

• The buffer is full. 

• An input end-of-block character is received by the 5100. 

• The ATTN key is pressed. 

During input operations initiated by a GET statement: 

a. If the character mode (see Set Character or Numeric Mode in Chapter 3) is 
specified, a record of 18 blanks is assigned to the referenced variables. 

b. If the character mode is not specified, an ERROR 010 A02 is returned. 

During input operations initiated by a LOAD command, the entire work area 
is cleared, including all key groups. 

• An error occurs. 

Except when using the character mode (F/C), the data placed in the buffer is a 
direct translation (character-by-character) of the data received. 


End-of-File Conditions During BASIC Input Operations 

During an input operation, an end-of-file condition means that the input device 
does not have any more records to transmit to the 5100. The Serial I/O Adapter 
feature recognizes an end-of-file condition when: 

• The input device indicates an end-of-file by dropping the data terminal ready 
signal. (See Chapter 4, Connector and Pin Assignments for more information 
on the data terminal ready pin.) 

• The CMD key is held and the 0 key (on the right side of the keyboard) is pressed. 

Note: CMD 0 is generally used when the input device does not indicate an end- 
of-file condition, even though it does not have any more records to transmit to 
the 5100. In this case, the 5100 waits for the input device to transmit data until 
CMD 0 is pressed. 

When the Serial I/O Adapter feature recognizes an end-of-file condition, an ERROR 
010 A02 is returned. 

Note: Because pressing CMD 0 causes the 5100 to recognize an end-of-file condition, 
CMD 0 should not be used as a function key when performing input operations. 



SPECIFYING THE DEVICE CHARACTERISTICS 

Before input and/or output operations can be performed, the command device 
should be opened and a PRINT statement used to specify the device characteristics. 

If the command device is not opened and the device characteristics specified, the 
default values for the device characteristics are used by the Serial I/O Adapter feature. 

Note: Once the Serial I/O Adapter program is loaded and a value is specified for a 
device characteristic, that value remains in effect until: 

a. Another value is specified 

b. The RESTART switch is pressed 

c. The 5100 POWER ON/OFF switch is turned off 

Following is an example of specifying some device characteristics: 

0 P E N F L..!., 1 A 0 8 ' , 0 U f -— 

^—Open the command device. 

-Output operation (information is always sent to 

the command device). 

-Device address (command device). 

-Logical file reference. 

P RIN T F L1 .■ ‘ X / 8 2 , E / 3 0 0 .. P / E ‘ -- 

i_i 

L-Specify the device characteristics. 

—In this case, the input buffer is set to 82 bytes, 
the data rate is set to 300 bps, and the parity 
is even. The remaining device characteristics 
are not changed from their present values. 


A $ ’ 1/82, E/3 
PRINT FL1,AT 


0 0,P/E ' 



A character variable specifying the device character¬ 
istics can also be used. 


The device characteristics can be specified in any order using one or more PRINT 
statements. 

Although it is not required, it is recommended that the command device be closed 
after the device characteristics are specified. For example: 

CLOSE I" LX -Now FL1 can be used as a file reference for some 

other purpose. 
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OPENING THE I/O DEVICE FOR INPUT OR OUTPUT OPERATIONS 


After the device characteristics are specified, the I/O device must be opened before 
an input or output operation can be performed. For example: 

OPEN FL2 .• ‘ A 0*1- ' .• OUT -*- Open an output device. 

I I L 

1 — Output operation. 

-Device address A04 (for output operations using PUT 

or PRINT statements). 

-Logical file reference. 


or 

OPEN FL3.' * A 02**1'N --Open an input device. 

t | L 

I-Input operation. 

-Device address A02 (for input operations using GET 

statements). 

-Logical file reference. 


Note About Opening I/O Devices 

If a BASIC program contains more than one OPEN statement with the same logical 
file reference (FLO through FL9), an ERROR 152 occurs if a later input or output 
operation uses a larger buffer size than the buffer size first specified for that logical 
file reference. This error condition can be avoided by: 

• Not using the same logical file reference for more than one OPEN statement in 
a program. 

• Specifying the largest buffer size required for input or output operations (using 
the same logical file reference) first. For example: 


0 010 OP 

IN ! : 

'Ll .• * A08 * ..OUT 

_Set the input buffer size (see Chapter 3) 

0020 PR 

I NT 

FL1.. ‘ I/I 000 * — 

to specify the largest buffer size. 

0030 CL 

:)SE 

FL:L 


0040 OP 

EN F 

• i o , • a n "> 1 . T kj __ 


I..I a., y 1 I u a.. .* .1. i \ 

- - Now, the logical tile reference rLz can 

0050 CL 

OSE 

FL2 

be used for input or output operations 
requiring buffer sizes up to 1000 bytes. 


0 09 0 

OPEN FL1 .. ‘AOS* ..OUT 


0 1 0 0 

PRINT FL1* *0/512* / 

An output operation using the logical file 

011 0 

CLOSE FL1 ) 

> reference FL2 and a 512-byte output 

0120 

0130 

OPEN FL2 .• * A 0 4 ’ ..OUT 

P RIN T F L 2 .. * 0 U T P U T D A T A * 

| buffer. 






PERFORMING INPUT OR OUTPUT OPERATIONS 


After the I/O device is open, input operations can be performed using GET state¬ 
ments, or output operations can be performed using PUT or PRINT statements. 

For example: 

GET FL2, A$, B$, C$ — -— ln P ut 

PUT FL3 , X , 27,23 , ' A BCD * 1 _Output 

P RIN T F L 3 .■ X , 27 .23, * A B C D ' J 

Notes: 

1. The PUT statement is not normally used except to transmit data to an offline 
storage media (for example, punched tape). 

2. The PRINT statement has an advantage over the PUT statement because the 
data is left unblocked (only one record is placed in the buffer), and no delimiters 
(commas or quotes) are inserted. 

3. The statement PRINT FL3/ABC' transmits ABC plus as many blanks as in the 
remainder of the buffer. However, the following statements only transmit ABC 
plus an output new-line and output end-of-block character: 

A$“ = X ‘ E3FF ‘ --Hex E3 is the 5100 end-of-record character and 

P RIN T FL3 > ' ABC * ; A$ Hex FF is the 5100 end-of-buffer character. 

4. To transmit a record containing only blanks, hex E3FF must follow the blanks 
in the buffer, for example: 

’ E3FF ‘ Transmits a record of one blank 

PRINT FL..3.« ' ‘ ; A$ character. 

5. Character mode (see Set Character or Regular Mode in Chapter 3) allows any 
character-only input data to be read with a GET statement by automatically 
providing the necessary delimiters and placing the input data in the buffer in 
blocks of 18 characters. 


CLOSING THE INPUT OR OUTPUT DEVICE 

After the input or output operation is completed, the I/O device should be closed. 
For example: 

CLOSE PL2 
CLOSE FL3 

Note: If a device is left open, it is automatically closed when the program ends. 
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LOADING, LISTING, OR PUNCHING A BASIC PROGRAM 


After the device characteristics are specified (see Chapter 3), a BASIC program can 
be loaded (input), listed (output), or punched (output) on an appropriate I/O device 
using the LOAD or SAVE commands. For example: 

LOAD 1 .• A2 0 - Load a BASIC program from an input device. 

1 -Device address A20 (for input operations using 

the LOAD command). 


File 1 must always be specified. 


SAVE 


,SOURCE 




■List or punch a BASIC program on an output 
device. 

Device address A40 (for output operations using 
the SAVE command). 


The BASIC program must be in SOURCE format. 


File 1 must always be specified. 


Notes: 

1. When loading a BASIC program from an input device that does not indicate end- 
of-file conditions (see End-of-File Conditions During BASIC Input Operations 

in this chapter), CMD 0 must be pressed after the last record is transmitted to 
complete the operation. If the ATTN key is pressed instead of CMD 0, the 
entire work area is cleared. 

2. When using 8-bit code, BASIC programs cannot be loaded, listed, or punched 
using an I/O device. 



SPECIAL CHARACTERS 


For a BASIC-Only Keyboard 

Some of the special characters that are used with the Serial I/O Adapter feature 
are not shown on the BASIC-only keyboard. Figure 1 shows the combined 
BASIC/APL keyboard with the special characters shown on the keys. To enter the 
special character desired, press the corresponding key on the BASIC-only keyboard 
(Figure 2). For example, to enter the character V: 


1 . 


Press and hold the shift key 


Press the 


□ 


key to enter the character V 


Some of the special characters are formed using two characters. For example, to 
enter the character f: 


Press and hold the shift key 


Press the 


□ 


key to enter the character V 


3. Press the backspace key 


4. Press the 


□ 


key to enter the character | over the character V; this 


forms the character ^ 
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Figure 1. Combined BASIC/APL 5100 Keyboard 



Figure 2. BASIC-Only 5100 Keyboard 
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The following chart shows the special characters and the BASIC-only key(s) that 
you must press to enter each character. Press and hold the shift key as you enter 
the character(s) unless indicated otherwise: 


Special 

Character 

Key(s) 

Special 

Character 

Key(s) 

Special 

Character 

Key(s) 

a 

□ 

c 

□ 

i 

□ 

¥ 

□□ 

A 

(HD 

P 

□ 

T 

□ 

H 

(HD 

L 

□ 

1 

□ 

V 

□ 

•• 

□ 


□□ 

\ 

I / Lower 
'-Shift 

A 

Q 


□CD 

X 

rn 

l JV see 

^^note) 

A 

00 

© 

□□ 

V 

□ 

_ 

□ 

® 

□0 

- 

□ 

A 

□ 

$ 

□CD 

R 

CHD 

A 

00 

D 

□ 

O 

□ 

~ 

□ 

n 

□ 

o 

□ 

OJ 

Q 

u 

□ 

□ 

□ 

/^through 

Example: 

V 

0 

€ 

□ 

A 

□□ 

r 

□ 

□ 

(HD 


Lower 

Shift 


Note: The blank key is located in the upper right corner of the alphameric keys. 
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Special 

Character 


Key(s) 


! 


v Lower 

a 

□Oa 

V 

□ □ 

note; 

/ 

□□ 

Lower 

^shift 

\ 

me 


X 

mm 



Note: The blank key is located in the upper right 
corner of the alphameric keys. 


5100 Characters That Are Not Shown On The Keyboard 

There are three 5100 characters ( —i , %, and tf) used with the Serial I/O Adapter 
feature that are not on the 5100 keyboard. To enter the —i, %, or 4 characters, 
you must use the hexadecimal values X'6D', X'73', or X'7D', respectively. For 
example, the statements: 

B$=X'73‘ 

PRINT FL1 t *90’;B$ 

generates the record 90%. 




> 
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INPUT DATA FLOW WHEN USING BASIC 


The following diagram shows the data flow from an input device to the 5100: 



Data is received by the 5100 
until the input buffer is full 
or an input end-of-block 
character is received. 


Except when using the charac¬ 
ter mode, the data placed in 
the buffer is a direct transla¬ 
tion of the data received. 


The GET statement determines 
how many records at a time 
are removed from the buffer. 
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OUTPUT DATA FLOW WHEN USING BASIC 


The following diagram shows the data flow from the 5100 to an output device: 


PUT or 
PRINT 
Statement 


Records are placed into 
the buffer using PUT or 
PRINT statements. 


5100 Output Buffer 

When using PUT statements, records are 
placed into the buffer until it is full, then 
the records are transmitted. When using 
PRINT statements, one record is placed 
in the buffer and then transmitted. 

Notes: 

1. If an entire record cannot be placed in 
the buffer, the remaining portion of 
the record is placed in the buffer after 
the data already in the buffer is trans¬ 
mitted (that is, no data is lost). 

2. If the character hex FF (end of buffer) 
is encountered in the buffer, the 5100 
stops transmitting data. Therefore, 
any data following the hex FF charac¬ 
ter in the buffer is not transmitted. 


Translation 

Table 


Output 

Device 
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SAMPLE BASIC PROGRAM 


The sample BASIC program shows how input and output operations can be performed 
using the IBM 5100 Serial I/O Adapter feature and an IBM 2741 Communications 
Terminal that uses EBCD code. To understand this example, you should be familiar 
with the following 2741 characteristics: 

• Normally attaches to a modem (data set). Therefore, the modem cable attaches 
the 2741 to the 5100. 

• Uses 6-bit code. 

• Requires a data rate of 134.5 bps. 

• Uses the APL character format. 

• Is placed in transmit mode when the POWER ON/OFF switch is turned on. 

• When transmitting data: 

a. Sends character to indicate the start of the data. If the APL translation 
table is specified, the 5100 character ] is equivalent to the (5) character. If 
the BASIC translation table is specified, the 5100 character # is equivalent to the 

character. 

b. Sends a (cT) ( t ) character to indicate the end of the data (end of transmission). 

• Must receive a (d) character to identify the start of a message and a (c) character to 
indicate the end of data. 
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0 0 1 0 
0 0 2 0 
0 0 3 0 
0 0 4 0 
0 050 
0 0 6 0 
0 0 7 0 
0 08 0 
0 0 9 0 
0 1 0 0 
o:!. :i. o 
o:i.20 
0 13 0 
0 14 0 
0 150 
0160 
0 17 0 
0180 
0190 
0 2 0 0 
0210 
0 22 0 
0 23 0 
0 24 0 
0 23 0 
0 26 0 
0270 
0 280 
029 0 
0 30 0 
031 0 
0320 
0 33 0 
034 0 
0 35 0 


OPEN 

PRINT 

REM 

REM 

REM 

REM 

REM 

REM 

OPEN 

PRINT 

GET F 

PRINT 

CLOSE 

REM 

REM 

REM 

REM “ 

REM ■ 

PRINT 

P PINT 

CLOSE 

REM 

REM 

REM 

OPEN 

B$X ' 

PRINT 

INPUT 

f $"" * ::i 

PRINT 

CLOSE 

END 


-Specify the device characteristics. /Automatically block the input from 

/ the 2741 into 18-character blocks 

I | • a ,-j p t ■ Q| j j f enclosed in single quotes. 

FL1 , * R/134.5,0/ .132 , I./132 , B/ f * l< /S .■ F/C .• A/B 1 


■ Turn clear to send (CTS) on for the 5100 
and ignore any request to send (RTS) 
from the 2741. 


Input operation. 


The Serial I/O Adapter feature uses the default value for any device 
characteristic not specified. 


•j .**) i p| Q * *|* ^uqiauLci iou^ iiui ofjcumcu. 

‘THE 5100 IS WAITING FOR INPUT FROM THE 2741' 


■Display this message to indicate when the 5100 is waiting for input 
from the 2741. 


Display the input from the 2741. 


Specify an immediate delay (the command device is still open). 


'THE 5100 IS DELAYING 1 MINUTE 


1, 1 D/60 0 


Output operation. 


FL3 f ' A04 1 >OUT 


The 5100 stops processing for one minute. 


'ENTER THE MESSAGE TO THE 2741 IN SINGLE QUOTES’ 

C$ 

* .... |_The ] is converted into the © for the 2741. The @ character 

....,'“ must precede any data to the 2741. 


"Send the message to the 2741. 
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Using the Sample BASIC Program 


Before the sample BASIC program can be used, the following steps must be 
performed: 

1. Attach the 2741 to the 5100 with the modem cable. 

2. Place the 5100 BASIC/APL switch in the BASIC position and turn the power 
on to the 5100 and the 2741. 

Note: If the 5100 power is already turned on, but the APL language is active, 
place the 5100 BASIC/APL switch in the BASIC position and press RESTART. 

3. Place the tape cartridge containing the Serial I/O Adapter program into the 
built-in tape unit and enter the command: 

UTIL MODE COM 

Press EXECUTE. 

4. When the option menu is displayed, enter: 

6 

The message ,READY, is displayed when the Serial I/O Adapter program is 
loaded into the work area. 

5. Place the sample program into the work area (either by loading it from a tape 
cartridge or entering it from the keyboard). 
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Now, you can use the sample BASIC program to perform input and output opera¬ 
tions with the 2741. For example: 

1. Enter RUN and press EXECUTE to start the program. 

2. When the 5100 displays THE 5100 IS WAITING FOR INPUT FROM THE 
2741, enter FROM THE 2741 on the 2741 keyboard. As you are entering 
the data on the 2741 keyboard, notice the in the bottom right corner of 
the 5100 display screen. This arrow moves in a back-and-forth motion as 

the 5100 receives data from the 2741 (for more information on the Input and 
Output Process Arrows, see Chapter 2). After you enter the data on the 2741, 
press the RETURN key. The message you entered is then displayed by the 
5100. 

3. After the 5100 displays the message from the 2741, it displays THE 5100 IS 
DELAYING FOR 1 MINUTE. Now, the 5100 will not process any state¬ 
ments or commands for one minute. 

4. After the one minute delay, the 5100 displays ENTER THE MESSAGE TO 
THE 2741 in single quotes. When this message is displayed, enter 'FROM 
THE 5100' and press EXECUTE. Notice the -> in the bottom right corner 
of the 5100 display screen. This arrow moves in a back-and-forth motion as 
the 5100 transmits data to the 2741. The message you entered is then 
typed on the 2741. 


This completes the execution of the sample BASIC program. 



Chapter 6. Serial I/O Adapter Characteristics and Specifications 


The IBM 5100 Serial I/O Adapter feature has the following characteristics: 

• Allows the 5100 to operate like a terminal or modem (under user-program 
control). 

• Allows a data rate from 20 bps (bits per second) to 9600.5 bps; the data rate 
can be specified to a half cycle (for example, 134.5). 

• Uses the 5-bit (no parity), 6-bit (plus parity), 7-bit (plus parity), and 8-bit (no 
parity) codes. 

• The 5100 cannot transmit and receive simultaneously. 

• When the 5100 is transmitting, it does not recognize a break (also called a long- 
space or receive interrupt). 

• When 5-, 6-, or 7-bit code is being transmitted, a space is transmitted for a 
3-character time span when a IU character is processed. This 3-character time 
span is called a long space or break. 

• Conforms to the EIA RS232C/CCITT V.24-V.28 standard for all signal levels 
and terminations. 

• Deviates from the EIA RS232C/CCITT V.24-V.28 standard (for request to send 
[RTS] and clear to send [CTS] conventions) when the 5100 is in ignore, wait, 
or set mode. 

• Uses all of the signals required by the EIA RS232C/CCITT V.24-V.28 interface 
for half duplex operation, when the 5100 is in modem or terminal mode. 

Note: When the 5100 is being used in terminal mode, the direction of the 
signals at the 5100 serial I/O connector do not conform to the EIA RS232C/ 
CCITT V.24-V.28 standard. However, the terminal cable interchanges certain 
pin assignments to provide EIA RS232C/CCITT V.24-V.28 standard pin assign¬ 
ments in terminal mode. See Connector and Pin Assignments for more 
information on the direction of the signals when using the 5100 in terminal 
mode. 

• Recognizes an end-of-file condition when an I/O device drops the data terminal 
ready signal or if CMD 0 is entered from the 5100 keyboard during an input 
operation. 
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CONNECTOR AND PIN ASSIGNMENTS 


The 5100 connector socket is wired so that the 5100 simulates a modem (data 
set). When the 5100 is used as a terminal, the terminal cable interchanges the 
following signals at the I/O device connector socket: 

• Transmitted data with received data 

• Request to send with clear to send 

• Data terminal ready with data set ready 

The pin assignments for the interface signals at the 5100 Serial I/O Adapter 
connector socket, the modem cable I/O device connector socket, and the terminal 
cable I/O device connector socket are as follows: 


5100 Serial I/O Adapter Connector 
Socket and Modem Cable I/O Device 
Connector Socket 


8 7 6 5 4 3 2 1 





At the 5100 

Connector 

Pin 

Number 

Socket 

1 

Protective ground 


2 

Transmitted data 

To 5100 

3 

Received data 

From 5100 

4 

Request to send 

To 5100 

5 

Clear to send 

From 5100 

6 

Data set ready 

From 5100 

7 

Signal ground 


8 

Received line signal 



detector 

From 5100 

20 

Data terminal ready 

To 5100 


Terminal Cable I/O Device Connector 
Socket 


1 2 3 4 5 6 7 8 



Direction of Signal 


At the Modem 

At the Terminal 

Cable I/O Device 

Cable I/O Device 

Connector Socket 

Connector Socket 

To 5100 

From 5100 

From 5100 

To 5100 

To 5100 

From 5100 

From 5100 

To 5100 

From 5100 

To 5100 


From 5100 See note 

To 5100 From 5100 


Note: The received line signal detector (pin 8) can be used as the originate signal, how¬ 
ever, this signal is not supplied by the terminal cable. 








Appendix A. Set-Up Procedure 


Use the following procedure to verify the operation of the Serial I/O Adapter 
feature: 

1. Insert the tape cartridge containing the Serial I/O Adapter program into the 
5100 built-in tape unit. 

2. Enter the command to display the option menu: 

a. If you are using APL, enter: 

)MODE COM and press EXECUTE 

b. If you are using BASIC, enter: 

UTIL MODE COM and press EXECUTE 

3. When the option menu is displayed, enter 8. This loads the Serial I/O 
Adapter program for 8-bit code. 

a. If you are using APL, CLEAR WS is displayed when the Serial I/O Adapter 
program is loaded. 

b. If you are using BASIC, READY is displayed when the Serial I/O Adapter 
program is loaded. 

4. Enter the following program: 

a. If you are using APL, enter: 

VSERIAL ;A:B 
i:: :i. ::i i osvo ' a 1 

1 : 2:1 * OUT 3:l.0 0:l. TYPE-1 

i:3:i Af • D/6 0 0 ‘ 
i: i-i :i A \ 0 

i:5:i ‘ TEST COMPLETE * 

1 :6 :i v 

b. If you are using BASIC, enter: 

0 010 OPEN ELI, ‘A08 * ,OUT 
0 02 0 PRINT FL1, * D/6 0 0‘ 

0030 CLOSE FL1 
0 0 4 0 P RIN T ‘ "f E S T C 0 M P L E ‘ 

0050 END 


Press EXECUTE after each 
line. 


Press EXECUTE after each 
line. 


IE 
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5. Execute the program: 

a. If you are using APL, enter: 

SERIAL and press EXECUTE 

b. If you are using BASIC, enter: 

RUN and press EXECUTE 

There should be one minute between the time you execute the program and 
the time the message TEST COMPLETE is displayed. 

If the message TEST COMPLETE is displayed in one minute, the checkout "v > 

of the Serial I/O Adapter feature is complete. 

6. If the message TEST COMPLETE is not displayed in one minute, press 
RESTART and start from step 1 again. If you do not get the message 
TEST COMPLETE the second time, see the Serial I/O Adapter Self Test 
later in this appendix. 


ATTACHING THE EXTERNAL I/O DEVICE 

There are two cables supplied with the Serial I/O Adapter feature. One cable is 
labeled Serial I/O Modem Attach (the modem cable) and the other cable is 
labeled Serial I/O Terminal Attach (the terminal cable). The modem cable, with 
an AMP 205207-1 receptacle, is used when the 5100 is used as data communica¬ 
tions equipment. The terminal cable, with an AMP 205208-1 plug, is used when 
the 5100 is used as data terminal equipment. 
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Serial I/O 
Modem Attach 



Terminal Attach 


o 


o 







SERIAL I/O ADAPTER SELF TEST 


The Serial I/O Adapter self test is provided to help you isolate problems between 
the 5100 and the attached device. To run the test: 

1. Load the Serial I/O Adapter program. 

2. Enter T when the option menu is displayed. This loads the test program 
and displays the following instructions: 

DISCONNECT THE SERIAL I/O 
ADAPTER CABLE FROM THE I/O 
DEVICE. 

CONNECT THE WRAP CONNECTOR TO 
THE END OF THE SERIAL I/O 
CABLE. 


PRESS EXECUTE TO CONTINUE 


The two wrap connectors are stored in the Maintenance Library Manual binder. 
The wrap connector used for the Serial I/O Adapter connector or the modem 
cable is a plug (has pins), and the wrap connector used for the terminal cable is 
a receptacle (does not have pins), as shown in the following illustration: 




Wrap Connector for the 
Terminal Cable 


Wrap Connector for the 
Serial I/O Adapter Connector 
or Modem Cable 




3 . 


Install the appropriate wrap connector to the end of the Serial I/O Adapter 
cable, or remove the Serial I/O Adapter cable at the back of the 5100 and 
install the appropriate wrap connector to the Serial I/O Adapter connector 
at the back of the 5100 as shown in the following illustration: 
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4. After you install the wrap connector, press the EXECUTE key. One of the 
following messages is displayed, giving you the results of the test: 


NO TROUBLE FOUND 

DIS C 0 N N E C T T H E W R A P C 0 N N E C T 0 R 
FROM THE END OF THE SERIAL I/O 
CABLE. 

CONNECT THE SERIAL I/O CABLE TO 
THE I/O DEVICE. 


PRESS EXECUTE TO RETURN TO OPTION MENU 


E R R 0 R F 0 U N D IN S E RIA L I / 0 
FEATURE, 

CALL YOUR SERVICE 
REPRESENTATIVE. 

DISCONNECT THE WRAP CONNECTOR 
FROM THE END OF THE SERIAL I/O 
CABLE. 

CONNECT THE SERIAL I/O CABLE TO 
THE I/O DEVICE. 

PRESS EXECUTE TO RETURN TO OPTION MENU 


If the Serial I/O Adapter is functioning normally, the message NO TROUBLE 
FOUND is displayed. If the Serial I/O Adapter is not functioning normally, 
call your service representative. 

5. To continue, press EXECUTE to return to the option menu. 






Appendix B. 5-Bit Code Conversion Chart 


The 5-bit code conversion chart shows the equivalent 5100 character for each 
5-bit code, and vice versa. This chart also shows the communications Baudot 
character for each 5-bit code. The Col/Row column in the conversion chart 
shows the two-digit value required to change the input or output translation tables. 
(See Change the Output Translation Table and Change the Input Translation Table 
in Chapter 3 for more information on changing the translation tables.) 

Note: If the input or output translation table is changed by the user, the 
equivalent 5-bit code or 5100 character might not be the same in the translation 
table as shown in the conversion chart. 
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NOTES ABOUT LETTERS (LOWER SHIFT) AND FIGURES (UPPER 
SHIFT) 


At the beginning of a transmit or receive operation, the 5100 assumes letters 
(lower shift). However, when all letters are being transmitted, the following 
characters can be used to change only the output device from letters (lower shift) 
to figures (upper shift), and vice versa: 

4 — Sets the output device to figures (upper shift) 

f — Sets the output device to letters (lower shift) 

Unless you specify otherwise, characters that can be both lower shift and upper 
shift (for example, n) are always transmitted to the I/O device as letters (lower 
shift). To transmit these characters as figures (upper shift), you must use the 
c>col/row user-specified device characteristic and specify the upper shift col/row 
value. For example, if the device characteristic n>42 is specified, the n character 
is transmitted as figures (upper shift). 
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Appendix C. 6-Bit Code Conversion Chart 


'V 0 ' 


The 6-bit code conversion chart shows the equivalent 5100 APL or BASIC charac¬ 
ter for each 6-bit code, and vice versa. This chart also shows the EBCD character 
for each 6-bit code. The Col/Row column in the conversion chart shows the three- 
digit value required to change the input or output translation tables. (See Change 
the Output Translation Table and Change the Input Translation Table in Chapter 3 
for more information on changing the translation tables.) 

Note: If the input or output translation table is changed by the user, the equivalent 
6-bit code or 5100 character might not be the same in the translation table as shown 
in the conversion chart. 
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\ 
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IL 
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X 
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& 
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Sc 

+ 

301 

701 
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« 

A 

A 
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A 
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702 

B 


B 

B 

B A 2 

b 

B 
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703 
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n 
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c 
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D 
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d 
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705 
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e 
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V 

G 
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g 
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• 
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At 
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At 
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At 
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PF 
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8 

8 
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HT 
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¥ 

¥ 

? 
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LC 
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Definition of E BCD Control Characters 


Control 

Character 

Definition 

Equivalent 5100 
Character 

PN 

Punch on 

A 

PO 

Punch off 

V 

BY 

Bypass 

A 

RES 

Restore 

V 

RS 

Reader stop 

$ 

LF 

Line feed 

4> 

NL 

New line 

i 

HT 

Horizontal tab 

© 

UC 

Upper shift (output only) 

* 

LC 

Lower shift (output only) 


EOB 

End of buffer 

® 

BS 

Backspace 

i 

EOT 

End of transmission (C^ 

▼ 

PRE 

Prefix 

ft 

IL 

Idle (ignored on input operations) 

\ 

DEL 

Delete 

/ 

EOA 

End of address (5) 

# (for BASIC) 


Long space (output only) 

] (for APL) 

[•] 


When the Serial I/O Adapter feature processes a [^character, the transmitted data 
line is turned off for a three-character time span. The three-character time span is 
called a long space or break. 


NOTES ABOUT LOWER SHIFT AND UPPER SHIFT 

The upper shift BASIC characters in the conversion chart are not always on the 
same keys as the corresponding lower shift BASIC characters. This chart simply 
indicates the equivalent upper shift 5100 BASIC character for each upper shift 
EBCD character. 

At the beginning of a transmit or receive operation, the 5100 assumes lower shift. 
However, when all lower shift characters are being transmitted, the following 
characters can be used to change the output device from lower shift to upper shift, 
and vice versa: 

^ — Sets the output device in upper shift 
f — Sets the output device in lower shift 

Unless you specify otherwise, characters that can be both upper shift and lower 
shift (for example: j ) are always transmitted to the I/O device in lower shift. To 
transmit these characters in upper shift, you must use the c>col/row device 
characteristic and specify the upper shift col/row value. For example, if the device 
characteristic f>415 is specified, the v character is transmitted in upper shift. 
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Appendix D. 7-Bit Code Conversion Chart 


The 7-bit code conversion chart shows the equivalent 5100 character for each 
7-bit code, and vice versa. This chart also shows the ASCII character for each 7-bit 
code. The Col/Row column in the conversion chart shows the three-digit value 
required to change the input or output translation tables. (See Change the Output 
Translation Table and Change the Input Translation Table in Chapter 3 for more 
information on changing the translation tables.) 

Note: If the input or output translation table is changed by the user, the equivalent 
7-bit code or 5100 character might not be the same in the translation table as shown 
in the conversion chart. 
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Appendix E. Device Address and User-Specified Device Characteristic Summary 



DEVICE ADDRESSES 

For APL: 

Device 

Address Use Syntax 

31 Open the command device S H A R E D A V A RIAB L E *• ' 0 U T 31 0 0 ’ 

32 Open the output device •:> H A Rl£ D A V A RIA BL E *• ' 0 Li T 3 2 0 0 1 T Y P E :::: I 

33 Open the input device 8ITAREDAVARI ABL.E** ' IN 330 0 '.!. 

34 Open the output device SNA RED A V A RI ABLE** ‘ OUT 34 0 0 I 



For BASIC: 


Device 

Address 

Use 

Syntax 


A08 

Open the command device 

statement number OPEN FL 

1 , ' A08 *, OUT 

A02 

Open the input device for 
a GET statement 

statement number OPEN FL 

1, 'A 02 1 ,IN 

A04 

Open the output device for 
a PUT or PRINT statement 

statement number 0 P E N F L 

1 , * A04‘ ,OUT 

A20 

Open the input device and 
LOAD a BASIC program 

LOAD 1,A2Q 


A40 

Open the output device and 
SAVE a BASIC program 

SAVE 1, SOURCE, AM-0. 




88 



USER-SPECIFIED DEVICE CHARACTERISTICS 


User-Specified Device Characteristics 

Set input buffer size 
Set output buffer size 
Set data rate 

Set character or numeric mode (5, 6, 
and 7-bit code) 


Syntax 

5-Bit 

l/n 

204 

0/n 

204 

R/n 

75 



■=/ ) \ 

N 

(c) 



N 


Default Values 
6-Bit 7-Bit 

8-Bit 

204 

204 

204 

204 

204 

204 

134.5 

110 

110 

N 

N 

C 1 


Set prompting or nonprompting mode 


H/ 


Set modem, ignore, terminal, wait, or 
set mode 


K/ 


M 


M 


M 


M 



j 

|°) 

1 




Set receive timeout 

T/ 

!nj 

> 0 

) 

0 

0 

0 

Set input prompting character 

C/p 

® 

v 

t 

11 

Set input new-line character 

N/c 


c 

f 

c 

8D 

Set input end-of-buffer character 

E/c 


c 

? 

c 

8D 

Set output new-line character 

L/c 


c 

I 

c 

8D 

Set output end-of-buffer character 

Set enable or disable input 

B/c 

1 

[ E i 

n 

1 

I 

n 

0A 

new-line and input end-of-block 
characters 

Z/ < 

i 

Id! 

f E 

E 

E 

E 


Set enable or disable output 
new-line and output end-of-block 
characters 


Y/ 


1 


These default values cannot be changed and an error occurs if the device characteristic is specified. 
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User-Specified Device Characteristics 

Set immediate delay 

Set APL or BASIC translation table 
(6-bit code only) 

Change the output translation table 
(5-, 6-, and 7-bit code) 

Change the input translation table 
(5-, 6-, and 7-bit code) 

Set input/output parity (7-bit code only) 

Set number of stop bits (7- and 8-bit code) 


Default Values 

Syntax 5-Bit 6-Bit 7-Bit 8- 

D/n 



c>col/row 


c< co I/row 



i 


These default values cannot be changed and an error occurs if the device characteristic is specified. 



Appendix F. Error Messages 


The error messages displayed when you are using the Serial I/O Adapter feature are 
associated with: 

• The Serial I/O Adapter feature 

• The APL or BASIC languages 

• A nonzero return code assigned to an APL shared variable. (In this case, no 
error message is displayed when the MSG=OFF parameter is specified.) 

Most of the error messages associated with the Serial I/O Adapter feature are dis¬ 
played in the format: 

ERROR eee ddd 

where eee is the error code and ddd is the device address in error (031-034 for APL 
or A02-A08 for BASIC). 

See the IBM 5100 APL Reference Manual, SA21-9213, or the IBM 5100 BASIC 
Reference Manual, SA21 -9217, for a description of the error messages associated 
with the APL or BASIC languages. 

Note: Some of the error messages displayed might also be followed by the message 
PRESS EXECUTE; for example: 

ERROR 007 E80 PRESS EXECUTE 

In this case, the only valid user response for the error message is to press EXECUTE 
to return to the APL or BASIC language. 

See the IBM 5100 APL Reference Manual, SA21-9213, for a description of the 
error messages associated with a nonzero return code assigned to an APL shared 
variable. 

The following list contains the error messages associated with the Serial I/O 
Adapter feature along with some possible causes for the error condition and a 
suggested user's response. 

Note: For BASIC operations, any error deactivates the keys on the keyboard and 
causes the display screen to flash. Before you try to correct the error condition, 
press ATTN to stop the flashing display and then enter GO END to end the 
program. 
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Error Message 

Cause 

User's Response 

ERROR 002 ddd 

An invalid command was 
sent to an I/O device. 

For example, a REWIND 
(BASIC) or )REWIND 
(APL) command is 
issued to an I/O device. 

You cannot specify the com¬ 
mand to the I/O device. 


An invalid device charac¬ 
teristic was specified to 
the command device. 

Respecify the device character 
istics correcting the invalid 
device characteristic. 


The input buffer size was 
changed after the input 
device was opened. 

Close the input device, 
change the buffer size, then 
reopen the input device. 


An invalid parameter was 
specified when opening 
the command device or an 
I/O device. 

Reenter the statement cor¬ 
recting the invalid parameter. 


ERROR 003 ddd In modem mode, data 
terminal ready from the 
I/O device is off during 
a 5100 transmit opera¬ 
tion. In terminal mode, 
data set ready from the 
I/O device is off during 
a 5100 transmit opera¬ 
tion. These conditions 
can be caused by: 

• The I/O device does not 
conform to the El A 
RS232C/CCITT V.24-V.28 
standard interface. 

• A defective cable. 

• The I/O device power 
is not on. 

• The I/O device is 
attached with the 
wrong cable. 


Replace the defective cable 
and retry the operation. 

Turn the I/O device power 
on and retry the operation. 

Use the correct cable and re¬ 
try the operation (see Appen¬ 
dix A. Set-Up Procedure for 
more information on which 
cable to use). 



Error Message 


Cause 


User's Response 


ERROR 003 ddd 
(continued) 


In modem mode, request 
to send (RTS) from the 
I/O device dropped during 
a 5100 receive operation. 

In terminal mode, clear to 
send (CTS) from the I/O 
device dropped during a 
5100 transmit operation. 
These conditions can be 
caused by: 

• The I/O device does not 
conform to the El A 
RS232C/CCITT V.24-V. 
interface. 


Try using ignore or set mode 
(see Chapter 3). 


• A defective cable. 

• The I/O device is 
attached with the 
wrong cable. 


• The I/O device power 
is not on. 

• The wrong mode 
(modem, ignore, ter¬ 
minal, or set) is specified. 

• Hardware malfunction. 


Replace the defective cable 
and retry the operation. 

Use the correct cable and 
retry the operation (see 
Appendix A. Set-Up Pro¬ 
cedure for information on 
which cable to use). 

Turn the I/O device power 
on and retry the operation. 

Specify the correct mode 
(see Chapter 3) and retry the 
operation. 

Try the operation again. If 
the error occurs again, try to 
determine if the error is 
caused by the I/O device or 
the 5100. Then call the 
appropriate service 
representative. 


Error Messages 93 



Error Message 

Cause 

User's Response 

ERROR 004 ddd 

Hardware malfunction. 

Try the operation again. If 
the error occurs again, call the 
service representative. 

ERROR 010 ddd 
(BASIC only) 

The 5100 recognized an 
end-of-file condition. 

This condition can be 
caused by: 

This is a warning message only. 


• Entering CMD 0. 



• In numeric mode, a 
receive timeout 

condition occurred and 
there were not enough 
records in the buffer 

for the GET statement. 

(In this case, any exist¬ 
ing data in the buffer 
is lost.) 



• In modem mode, data 
terminal ready from the 
I/O device is off during a 
5100 receive operation. 



• In terminal mode, data 
set ready from the I/O 
device is off during a 

5100 receive operation. 


ERROR 013 ddd 

The Serial I/O Adapter 
feature hardware is not 

installed or it is defective. 



The Serial I/O Adapter 
program is not loaded in 
user storage. 

Load the Serial I/O Adapter 
program. 

ERROR 014 ddd 

An invalid device address 
was specified. 

Reenter the statement, correct¬ 
ing the invalid device address. 
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Error Message Cause 


User's Response 


INVALID FILE PRESS EXECUTE 


The Serial I/O Adapter 
feature cartridge is not in 
the built-in tape unit when 
an option is selected from 
the option menu or there 
is a problem with the Serial 
I/O Adapter feature 
cartridge. 


Press EXECUTE to return to 
the APL or BASIC language. If 
the error is caused by the wrong 
tape cartridge in the built-in tape 
unit, insert the Serial I/O Adapter 
feature cartridge and load the 
Serial I/O Adapter program again. 
If the error is caused by the Serial 
I/O Adapter cartridge, call the 
service representative. 


WORKSPACE FULL PRESS EXECUTE The Serial I/O Adapter 

requires more storage 
than is available in your 
5100. 


Press EXECUTE to return to the 
APL or BASIC language. 
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break: 1, A 3-character time span transmitted by the 5100 when a H is encountered 
in the output buffer (for 5-, 6-, and 7-bit code only). 2. A request made by the 5100 
for the input device to stop transmitting data. 

buffers: A part of the 5100 user storage reserved for input and output operations. 

character mode: (BASIC only) A mode of operation where character-only input data is 
automatically blocked into 18 characters with each block enclosed in single quotes and 
separated by a comma. 

clear to send (CTS): An indication by the 5100 or I/O device that it is ready to receive 
data. 

command device address: 1. The device address used for specifying the device character¬ 
istics. 2. Addresses an area of storage in the user storage where the user-specified device 
characteristics are stored. 

end-of-buffer code: A code (hex FF) that indicates the end of the data in the 5100 input 
or output buffer. 

end of file: A condition that exists when an input device does not have any more records 
to transmit to the 5100. 

end-of-record code: A code (hex E3) that indicates the end of a record in the 5100 input 
or output buffer. When more than one record is in the buffer, this code is used to separate 
them. 

hexadecimal representation: A number system with a base of 16. The hexadecimal digits 
are 0-9 and A-F, where A represents the decimal value 10, B represents 11, and so on. 

I/O device: A device attached to the 5100 that transfers data to the 5100 or from the 
5100. 

ignore mode: A mode of operation where the 5100 does not check for a request to send 
before indicating whether or not it is ready to receive data. 

input device: A device attached to the 5100 that transfers data to the 5100. 

input end-of-block character: 1. A character transmitted from an input device that indi¬ 
cates a complete block of data was received by the 5100. 2. Indicates the end of trans¬ 
mission from the input device. 

input new-line character: A character transmitted from an input device that indicates a 
complete record was transmitted to the 5100. 

input operation: Transmitting data to the 5100 from an external I/O device. 



input operation: Transmitting data to the 5100 from an external I/O device. 

input prompting character: A special character automatically transmitted by the 5100 
to indicate it is ready to receive data. This character tells the input device when to start 
sending data. 

long space: See break. 

modem mode: 1. A mode of operation where the 5100 simulates a modem and indicates 
it is ready to receive data after the I/O device makes a request to send data. The 5100 
continues to indicate it is ready to receive data until the I/O device stops the request to 
send data. 

nonprompting mode: A mode of operation where the 5100 does not automatically trans¬ 
mit an input prompting character when it is ready to receive data. 

numeric mode: A mode of operation where the input data is not automatically blocked 
into 18 characters. The necessary delimiters must be provided as part of the input data. 

output device: A device attached to the 5100 that transfers data from the 5100. 

output end-of-block character: A character with a special meaning when transmitted to 
an output device; for example, to indicate a carriage return or line feed. 

output new-line character: A character with a special meaning when transmitted to an 
output device; for example, to indicate a carriage return or line feed. 

output operation: Transmitting data from the 5100 to an external I/O device. 

prompting mode: A mode of operation where the 5100 automatically transmits an input 
prompting character when it is ready to receive data. 

request to send (RTS): An indication by the 5100 or I/O device that it is ready to send 
data. 

set mode: A mode of operation where the 5100 sets request to send or clear to send on 
and ignores any request to send or clear to send indications from the I/O device. 

terminal mode: A mode of operation where the 5100 simulates a terminal and requests 
to send data and then begins sending data when the I/O device indicates it is ready to 
receive the data. 

translation tables: Tables used to convert 5100 characters into 5-, 6-, or 7-bit codes, and 
vice versa. 

user storage: The internal storage available for user-defined programs and data. 
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(CONTINUE command 35 
(MODE COM 3 
( T ) character 8,11 
, function 48 
fc) character 50, 65 
(d) character 50, 65 


adapt the 5100 3 

APL shared variable 3, 11, 14, 22, 24, 42 

APL translation table 36, 40 

ASCII characters 1,84 

atomic vector 48 

ATTN key 58,91 

APL operations 42,43 
BASIC operations 53,54 
available user storage 3 


BASIC source program 18,58 
BASIC translation table 36,40 
Baudot character 1,77 
binary character format 1 
break 69,83 
buffer 14,42,53 
buffer size 15,25,27,40 


cables 72 

catenate function 48 

character mode 18,27,40,54,57 

characteristics 69 

clear to send (CTS) 12, 30, 69 

clear to send signal 70 

close the command device 55 

closing the I/O device 42, 47, 57 

CMD 0 43, 54, 58, 69 

command device 3, 22, 24, 44, 55 

communications feature 1 

conventions 30, 69 

conversion chart 

5- bit code 77 

6- bit code 80 

7- bit code 84 
convert 6, 10 

copy a stored workspace 42 
CTS (see clear to send) 


data communications equipment 72 

data rate 26, 40, 69 

data set 70 

data set ready signal 70 

data terminal equipment 72 

data terminal ready 43, 54, 69 

data terminal ready signal 70 

data transferred immediately 22, 42, 49 

default value 40, 44, 55 

device address summary 88 

device addresses 22, 44, 45, 55, 56 

device characteristic summary 88 

device characteristics 2, 15, 22, 24, 44, 55 

disable actions taken by 5100 17,21,34 

disable input end-of-block character 17, 34 

disable input new-line character 17, 34 

disable output end-of-block character 21,35 

disable output new-line character 21,35 


EBCD characters 1,80 
EBCD code 50, 65 
EBCD control characters 83 
EIA RS232C specification 30, 69 
enable input end-of-block character 17, 34 
enable input new-line character 17, 34 
enable output end-of-block character 21,35 
enable output new-line character 21,35 
end of buffer code 16, 17, 20, 25 
end of file 69 
end of file conditions 
APL 43 
BASIC 54,58 

end of record code 16,17,19,25 

end of transmission 16 

error messages 91 

ERROR 002 ddd 92 

ERROR 003 ddd 92 

ERROR 004 ddd 94 

ERROR 010 A02 54 

ERROR 010 ddd 94 

ERROR 01 3 ddd 94 

ERROR 014ddd 94 

ERROR 152 56 

establish a shared variable 44 

even parity 39, 40 

EXCEEDS MAXIMUM RECORD LENGTH 
exchange data format 44, 45 
externa! I/O device 1,2 
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function key 54 


( 

general exchange data format 44, 45 
GET statement 4,15,23,27,57 


half duplex operation 69 
hexadecimal character 9 
hexadecimal constants 9 
hexadecimal representation 9, 10 

( 

I/O device 1,2,22 
I/O device requirements 3 
IBM 2741 communications terminal 50,65 
ignore mode 30, 40, 69 
IMFs 13 

immediate delay 36, 40, 51,66 
input data flow 
APL 48 
BASIC 63 
input device 22, 23 

input end of block character 11, 16, 33, 40, 46, 63 
input end of buffer condition 17 
input end of data condition 17 
input end of record condition 17 
input new line character 11, 16, 33, 40, 46, 63 
input operation 3,12,14,22,23 
input operations 
APL 42, 43, 46 
BASIC 53, 56, 57 
input parity 39, 40 
input process arrow 12 
input prompting character 29, 40 
input translation table 38, 40 
internal machine fixes (IMFs) 13 


keyboard 48,62 

C 

list a BASIC program 58 
load a BASIC program 53, 58 
load a stored workspace 42 
LOAD command 15, 23, 58 
V long-space 69,83 
loss of data 48, 63 
lost data 48, 63 
lower shift 79, 83 






modem 69,70 
modem cable 30, 72 
modem mode 30, 40 
MSG=OFF 44,45 


no parity checking 39, 40 
nonprompting mode 28, 40 
numeric mode 27, 40 


odd parity 39, 40 
OPEN statement 22, 55, 56 
opening the command device 3, 22, 44, 55 
opening the I/O device 3, 22 
APL 45 
BASIC 56 
option menu 3 
originate signal 70 
output data flow 
APL 49 
BASIC 64 
output device 22, 23 

output end of block characters 19, 21,33, 40 
output end of buffer conditions 20 
output end of data condition 20 
output end of record condition 20 
output new-line characters 19, 21,33, 40 
output operation 3,12,14,22,23 
APL 42,46 
BASIC 53,56,57 
output parity 39, 40 
output process arrow 12, 52, 67 
output translation table 37, 40 


parity 69 
parity error 8 

physical end of buffer 17,19,20,21 

pin assignment 69, 70 

PR I NT statement 3,11,14,23,53,57 

prompting mode 28, 40 

punch a BASIC program 58 

PUT statement 3, 11, 14, 23, 53, 57 


receive 69 
receive interrupt 69 
receive timeout 31 
received 6 

received data signal 70 
receiving data 1,11,12,46 
records 14 

request to send (RTS) 12, 30, 69 
request to send signal 70 
retract 47 

retracting the shared variable 47 
return code 31,44, 46 
RTS (see request to send) 
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sample APL program 50 
sample BASIC program 65 
SAVE command 14,23,53,58 
serial I/O adapter program 3 
serial I/O adapter self test 3, 72, 73 
serial I/O modem attach 72 
serial I/O terminal attach 72 
set mode 30, 40, 69 
set up procedure 63 
space 69 

special characters 48, 59, 62 
specifications 69 

specify device characteristics 22, 24, 44, 55 

stop bit error 8,11 

stop bits 39, 40 

stop processing 36 

summary 40 


terminal 69,70 
terminal cable 30, 69, 70, 72 
terminal mode 30, 40, 69 
test option 3, 1 3 
timing requirements 12 
transferring data 46 
translation tables 7, 37, 38, 40 

5- bit code 8 

6- bit code 8 

7- bit code 8 

8- bit code 10 
transmit 69 
transmitted 6 
transmitted data signal 70 
transmitting data 1,11,46 
TYPE= 44 


untranslatable character 8 
upper shift 79, 83 

user specified device characteristics 24, 44, 55 
user storage 3,14 
UTIL MODE COM 3 


wait mode 30 


5- bit code 1,3, 6, 8 

6- bit code 1,3, 6,8 

7- bit code 1,3, 6, 8 

8- bit code 1,3,9,15,58 
9 0 return code 31, 46 
5100 keyboard 48, 62 


100 



o 

V. y READER'S 

Please use this form only to identify publication errors or request changes to publications. Technical questions about IBM systems, changes in IBM programming 
support, requests for additional publications, etc, should be directed to your IBM representative or to the IBM branch office nearest your location. 

Error in publication (typographical, illustration, and so on). No reply. Inaccurate or misleading information in this publication. Please tell us 

about it by using this postage-paid form. We will correct or clarify the 
Page Number Error publication, or tell you why a change is not being made, provided you 

include your name and address. 

Page Number Comment 



O/IENT FORM 


[ | Check if reply is requested. 

Note: All comments and suggestions become the property of IBM. Name__ 

Address 


• No postage necessary if mailed in the U.S.A. 


IBM 5100 SA21-9239-1 

Serial I/O Adapter Feature 
Users Manual 



o 



■\. > 



Fold 


Fold 


BUSINESS REPLY MAIL 

NO POSTAGE STAMP NECESSARY IF MAILED IN THE UNITED STATES 


POSTAGE WILL BE PAID BY . . . 


IBM Corporation 
General Systems Division 
Development Laboratory 
Publications, Dept. 245 
Rochester, Minnesota 55901 


FIRST CLASS 
PERMIT NO. 387 
ROCHESTER. MINN. 



Fold 


Fold 


International Business Machines Corporation 
General Systems Division 
5775D Glenridge Drive N.E. 

Atlanta, Georgia 30301 
(USA Only) 

IBM World Trade Corporation 

821 United Nations Plaza, New York, New York 10017 
(International) 


IBM 5100 Serial I/O Adapter Feature Users Manual (Printed in U.S.A.) SA21 -9239-1 









o 







o 





SA21-9239-1 



f "\ 

V. J 


\ 

\ f 


International Business Machines Corporation 
General Systems Division 
5775D Glenridge Drive N.E. 

Atlanta, Georgia 30301 
(USA Only) 

IBM World Trade Corporation 

821 United Nations Plaza, New York, New York 10017 
(International) 


oo 


o 

o 


> 

CL 


T J 

5’ 

r+ 

fD 

a 

5" 

C 

GO 

> 


GO 

> 

ro 


co 

isj 

GO 

CO 


\ ' 




\ 


f \ 





